TABLE CONVERSION GUIDE
Convert Word tables to Markdown
Standard Word tables can become editable Markdown tables. Because Markdown tables are simpler than Word tables, review the result when the original uses merged cells, nested tables or complex layout.
Convert a DOCX fileHow a standard table maps
The converter reads the first row as the Markdown header, then writes the remaining rows as table data. A line break inside a cell is represented with <br>.
| Owner | Status |
| --- | --- |
| Maya | Ready |What Markdown tables can and cannot express
| Word table feature | Markdown result |
|---|---|
| Regular rows and columns | Converted to a Markdown table |
| Line breaks inside a cell | Represented with <br> |
| Merged cells | Cannot be represented exactly; review the flagged table |
| Nested tables or complex layout | May be simplified; compare with the source |
Review a converted table
Compare the number of columns
Check each row against the Word source. Confirm that values have not shifted into neighboring columns.
Check the header row
The first row becomes the Markdown header. If your Word table has a title row or no real header, adjust the Markdown before publishing.
Simplify merged layouts
For merged cells, consider splitting the table into smaller tables or moving explanatory text into a heading or paragraph.
Use the live converter
Convert your DOCX on the home page and review the generated Markdown. If the converter detects merged cells, it shows a note beside the result.