Open
Your workbook or CSV is read on your device. Every sheet is listed.
Spreadsheets & tablesFree table converter
Excel to Markdown Table
Turn an Excel sheet or CSV file into a clean Markdown table, with pipes escaped and columns lined up. Your spreadsheet is read in your browser and never uploaded.
Highlights
- .xlsx, .xls & .csv
- Pick any sheet
- Files stay on your device
- No sign-up
How to Convert Excel to a Markdown Table
This converter turns a sheet from an Excel workbook or a CSV file into a GitHub-flavoured Markdown table, ready for a README, wiki, issue, notes app or AI prompt.
The file is read inside this browser tab and never uploaded. You can also copy cells straight from Excel or Google Sheets and paste them in.
What you get
- Values as displayed — dates, currency and percentages look as they do in the sheet.
- Safe cells — pipes and Markdown characters are escaped, and line breaks become <br>.
- Tidy output — empty rows and columns removed, numbers right-aligned, columns lined up.
- Any sheet — pick a sheet from the workbook and choose whether the first row is the header.
To use this tool, start with Step 1 below. In Step 1: Add a spreadsheet, choose or drop an .xlsx or .csv file, paste cells, or load the example, then pick a sheet. In Step 2: Copy or download, check the preview, then copy the table or download it as a .md file.
Step 1 of 2
Add a spreadsheet
Choose or drop an Excel or CSV file (up to 10 MB), or paste cells copied from a spreadsheet.
or drop a file here. It stays on this device.
.xlsx, .xls, .ods, .csv or .tsv · up to 10 MB
0 characters · 0 lines
Sheet & options
Nothing is uploaded. Files are read in your browser.
Step 2 of 2
Copy or download
The Markdown table and its preview. You can edit the Markdown; changing the sheet or an option rewrites it.
0 characters · 0 lines
Preview
The table preview will appear here.
Excel to Markdown guide
From spreadsheet to pipe table in one paste
Writing a Markdown table by hand means counting pipes and dashes. This converter does it for you from any sheet, with special characters escaped so the table never breaks.
The basics
How does Excel to Markdown table work?
The spreadsheet is read in your browser with SheetJS, a widely used spreadsheet library, then each row is written out as a Markdown table row.
Read
Cells are taken as displayed in the sheet, so formats like dates and percentages are kept.
Tidy
Empty rows and columns are removed, and special characters in cells are escaped.
Write
A GitHub-flavoured Markdown table is written, with optional padding and number alignment.
What carries over
Spreadsheet features in Markdown
What each part of a sheet becomes in the Markdown table.
| In the spreadsheet | In Markdown | Good to know |
|---|---|---|
| First row | Header row | Or a generated Column 1, Column 2 header if your sheet has none. |
| Number columns | Right-aligned (---:) | Optional. Applies when every value in the column is a number. |
| Formatted values | As displayed | Dates, currency and percentages keep their look. |
| | in a cell | \| | Escaped so it never splits the cell. |
| Line breaks in a cell | <br> | Markdown table rows must stay on one line. |
| Formulas | Calculated results | The value is used, not the formula. |
| Several sheets | Choose one at a time | Hidden sheets are listed and marked. |
Use cases
When to convert Excel to Markdown
Put spreadsheet data wherever Markdown is read.
READMEs & docs
Add price lists, specs and comparison tables to GitHub, GitLab or a docs site.
Issues & pull requests
Paste test results or data summaries into a ticket as a readable table.
AI prompts
Give ChatGPT, Claude or Gemini a table as text, which they read more reliably.
Wikis & notes
Bring data into Notion, Obsidian, Confluence or any Markdown notes app.
Chat & forums
Post tidy tables on Discord, Reddit and Stack Overflow, which all support Markdown.
Static sites
Publish spreadsheet data on Hugo, Jekyll, Astro or Next.js pages.
Set expectations
What a Markdown table can't hold
Markdown tables are deliberately simple, so some spreadsheet features have nowhere to go.
Formatting
Colours, fonts, borders and cell styles are dropped.
Merged cells
The value appears in the first cell; the others are left empty.
Very wide sheets
Tables with many columns are hard to read in Markdown. Consider splitting them.
Going the other way? Markdown Table to Excel turns pipe tables back into a workbook.
Common questions
Excel to Markdown table FAQ
Quick answers about converting Excel and CSV files to Markdown tables.
How do I convert an Excel sheet to a Markdown table?
Choose or drop your .xlsx or .csv file in Step 1, or paste cells you've copied from Excel or Google Sheets. Pick the sheet you want if the workbook has several. The Markdown table appears in Step 2, ready to copy or download as a .md file.
Is my spreadsheet uploaded anywhere?
No. Your workbook or CSV is read inside your browser tab and never leaves your device. The page doesn't keep a copy, so refreshing clears it.
Which file types are supported?
Excel .xlsx, .xlsm and older .xls workbooks, OpenDocument .ods, and .csv and .tsv text files, up to 10 MB. You can also skip the file and paste cells copied from Excel, Google Sheets, Numbers or LibreOffice.
How do I convert a workbook with several sheets?
Every sheet in the workbook is listed in the Sheet menu. Choose one to convert it, then copy or download the result. Choose the next sheet to do the same for that one. Hidden sheets are listed too, and marked as hidden.
What if my sheet doesn't have a header row?
Untick First row is the header. A Markdown table must have a header row, so the tool adds one (Column 1, Column 2, and so on) and keeps your first row as data. You can rename the headers in the output before copying.
What happens to pipes (|) and other special characters in cells?
They're escaped, so a | inside a cell stays part of that cell instead of starting a new column. Characters that Markdown would treat as formatting, such as * and _, are escaped too, and line breaks inside a cell become <br>.
Are dates, currency and percentages kept?
Yes. Excel files are converted using the values as they're displayed in the sheet, so 45% stays 45% rather than 0.45 and dates keep their format. CSV values are kept exactly as written in the file.
Are formulas, colours and merged cells kept?
Formulas become their calculated results. Markdown tables have no colours, fonts, borders or merged cells, so those are dropped. A merged cell's value appears in its first cell.
Why are some columns right-aligned?
Columns where every value is a number are right-aligned (---:) so figures line up, like they do in a spreadsheet. Untick Right-align number columns to keep everything left-aligned.
What does Line up the columns do?
It pads cells with spaces so the pipes form neat columns when you read the Markdown as plain text. It doesn't change how the table looks when rendered. Turn it off for the shortest possible output.
Related converters
More converters
These tools also run in your browser, with no sign-up and nothing uploaded.