Document tools

Excel and CSV to Markdown converter

Turn a selected spreadsheet table into Markdown for a README, reference document or knowledge base. Choose a sheet and cell range, inspect the output, then copy or download it. No account is required.

How to convert an Excel table to Markdown

1. Choose your source. Open an XLSX workbook or a UTF-8 CSV file. If you are exploring, use the fictional sales workbook supplied in the tool.
2. Select the sheet and range. Each worksheet is listed separately. Enter a rectangle such as A1:F7 to include only the table you need. Remove title rows, footnotes and unrelated totals from the selection.
3. Choose values or formulas. Values are suitable for a readable reference table. Formulas are useful for documenting how a cell is defined. Neither option executes calculations.
4. Set the heading row. Keep the heading option enabled if the first selected row names the columns. Turn it off to retain the first row as data and generate neutral column headings.
5. Review and export. Compare important cells with the workbook before copying the Markdown or downloading table.md. Check the result in the Markdown application where you will use it.

Try a table with known results

The example workbook has four sheets: Read me, Deals, Targets and Checks. Choose Deals and A1:F7 to export six fictional sales records with their region, status, currency, amount and close date. The last record is D-106; its date belongs to September, not August.

On Checks, export A1:B3 in stored-values mode. The saved revenue check is 20,000.00 and target attainment is 80%. Switch to formula mode to inspect the spreadsheet expressions instead. These are saved fixture results, not calculations performed by this converter. The Excel guide explains the filters and expected answers.

You can also download the CSV version. CSV has no worksheets, number formats or native formula metadata. A value such as 001 remains text when read from CSV; a comma inside a quoted cell stays within that cell.

What the conversion preserves

The output is a rectangular Markdown table. Blank cells stay in position. In XLSX stored-values mode, saved number formats are used where the parser supports them: a percentage can appear as 80% instead of 0.8. CSV fields are treated as text, avoiding automatic conversion of identifiers into numbers.

A vertical bar inside a cell is encoded so it does not create another Markdown column. Cell line breaks become HTML break tags. Literal HTML and Markdown control characters are escaped. Markdown renderers differ, particularly in whether they support tables and HTML breaks, so the preview shows the actual export text rather than promising identical rendering everywhere.

Stored values and formulas answer different questions

A spreadsheet can contain both a formula and its cached result. The cached result may be old or missing if the workbook has not been recalculated and saved. The converter cannot determine whether it reflects the latest inputs. If a formula cell is blank in values mode, inspect it in formula mode and recalculate the original file before trying again.

Formula mode retains expressions as text. References still point to the original workbook’s cells; they do not become working references in Markdown. Copying an expression into a new spreadsheet may change its meaning if its source cells, named ranges or external workbooks are absent. Keep the workbook as the calculation source of record.

Limits to check before sharing

• Files are limited to 5 MB, 30 sheets, 2,000 rows and 100 columns per sheet, and 50,000 populated cells per file. A selected output can contain at most 10,000 cells and 1 MB of text. Larger workbooks should be reduced to the required table first.
• Charts, pictures, comments, pivot-table behavior, macros, conditional formatting and workbook layout are not exported. Merged cells retain their stored top-left content; merged layout is not reproduced.
• Hidden sheets are labelled in the selector. Hidden rows and filtered-out records within your selected range are still included. Review the range before sharing sensitive or excluded records.
• Encrypted files are unsupported. XLSX archives with more than 1,000 parts or over 20 MB of declared unpacked content are rejected. Processing is cancelled after 15 seconds so you can choose a smaller file.
• UTF-8 CSV is supported. Export another character encoding as UTF-8 if you see an encoding error. Check column boundaries when your export uses a nonstandard delimiter.

When Markdown is useful for a knowledge base

Use Markdown for a stable, readable table that belongs beside explanatory text: a product matrix, a small policy schedule or a glossary. Add the source filename, worksheet, range, owner and version date around the table. This context helps readers distinguish a maintained reference from an old export.

Keep a complex model in Excel when formulas, many linked sheets or ongoing calculations matter. Converting a table does not turn a document assistant into a spreadsheet engine. Ask Your Docs accepts spreadsheet uploads directly; this tool is an optional preparation step for a readable reference file. Start with the knowledge base starter kit if you need a source register and review questions.

Frequently asked questions

Method

The converter uses SheetJS Community Edition to read workbook cells in a browser worker. It formats the selected rectangle as a Markdown table, without running formulas or contacting an AI model. Compare source cells and the exported text before publishing a result.