Skip to content
FileMyLove

Markdown table columns wrong in Word? Check the source structure

Prepare a simple Markdown pipe table, distinguish column errors from Word layout, and check row meaning after DOCX conversion.

By FileMyLove Team1 min read

A table may look correct in a note-taking app but become plain text or misaligned columns in Word. Check the Markdown source structure before trying to fix the Word layout, particularly when the table was copied from chat.

Start with a small explicit table

Pandoc documents pipe tables with | column separators, a header and a separator row. Colons in that separator row indicate alignment. This invented example is a useful starting point:

| Item | Quantity |
|:-----|---------:|
| Notebook | 2 |
| Pen | 5 |

FileMyLove's Markdown-to-Word converter uses Pandoc's Markdown reader. Words lined up using spaces alone are not the same structure.

Separate structure from layout

Symptom Check first
Table appears as plain text Header, separator row and column separators
Values occupy wrong columns Cell boundaries in each row
Correct cells wrap across several lines Word column widths and page layout
A cell contains several paragraphs or lists Move those details outside the simple table

Pandoc's pipe-table syntax does not allow block content such as paragraphs and lists inside cells, or source rows spanning multiple lines. Visual wrapping in a narrow editor window is different from an actual newline in the file.

Convert and check meaning

  1. Retain the original Markdown.
  2. Test a short table first if the full source is complex.
  3. Convert the file to DOCX.
  4. Open Word and compare headers and values row by row.
  5. Adjust widths or divide a long table, then review before sending.

We recommend inspecting the longest entries and important numbers first. Matching the row count is not enough if a value ends up beneath the wrong heading.

Do not expect every preview to match

Markdown editors may support different extensions, while Word lays out content on pages. For a complex table, finish its structure in Word while retaining the source data for comparison. See Markdown headings and lists in Word for other elements. FileMyLove converts the document in your browser without uploading it.