Skip to main content

Markwrite / Tables

Markdown tables that arrive as real Word tables.

Tables are where every other Markdown-to-Word conversion quietly gives up: the pipes come out as tab-separated text, or as a picture of a table, or as a grid the recipient cannot edit. Markwrite turns each pipe table into a native Word table — cells, header row, alignment and borders.

Updated 8 November 2026 · macOS 14+

The short version

  • · Pipe tables become native, editable Word tables — not text, not images.
  • · Alignment markers in the delimiter row become cell alignment.
  • · Runs locally on your Mac: no Pandoc, no command line, nothing uploaded.

The problem

A table in Markdown is text. A table in Word is a structure.

In Markdown a table is just lines with pipes in them. There is no table model to preserve — which is why converters take shortcuts: some flatten rows into tab- or space-separated text, some render the table to an image so it looks right but cannot be edited, and some rebuild it with guessed column widths that shift the moment a cell holds more than a few words.

Word is the opposite: a table is an object with cells, a header row, alignment, borders and a style. Getting from one to the other is not formatting — it is rebuilding the structure, which is exactly the part that tends to get skipped.

What you get

The pipe table, rebuilt cell by cell.

Write the table the way you already write it:

| Plan     | Seats | Price  |
|:---------|------:|:------:|
| Starter  | 1     | $9     |
| Team     | 5     | $39    |

Export it as .docx and Word receives a table: two body rows and a header row, three cells in each, the price column right-aligned and the middle column centred — the alignment markers did their job. Click any cell and type: it is a Word table, not a picture of one.

In the .md fileIn the .docx
`| a | b |` header rowA real header row, repeatable across pages
`:---` / `---:` alignmentCell alignment, kept
Each pipe cellA separate editable cell
Backticks in a cellMonospaced text inside the cell
Line breaks inside a rowNot valid Markdown — split the row

How it works

Three steps, no terminal.

1. Open the file. Any .md file opens with a live preview, so the table is visible exactly as it will print — headers, alignment and all.

2. Export as Word. Choose the .docx export. The conversion runs natively on the Mac; there is no Pandoc to install and no reference document to maintain.

3. Hand it off. The .docx opens in Word, Pages, Google Docs or LibreOffice, with the table intact and editable. Anything Markdown cannot express — merged cells, a nested table — is a ten-second fix in Word.

Limits

What a .md file cannot tell us.

Standard Markdown and GFM have no syntax for merged cells, row spans, nested tables or multi-row headers. No converter can invent them, and a tool that claims otherwise is guessing. What you get is a clean grid of cells with the right text and alignment; merges and styling are a minute's work in Word afterwards.

Very wide tables are also worth a thought before exporting: Markdown has no concept of page width, so a twelve-column table will arrive in Word and then need orientation or font-size decisions that only you can make.

Or Pandoc

Pandoc can do tables. It also asks for a reference doc.

Pandoc is free, scriptable and genuinely powerful — and if you already live in the terminal, it is a fine answer. The cost is setup: flags, a reference.docx to define styles, and a build step to keep it working. For a one-off handoff, that is a detour.

Markwrite takes the shortest path: open, export, send. Same native tables, no command line, nothing uploaded.

FAQ

Questions, answered.

Do Markdown tables become real Word tables?

Yes. A pipe table in the Markdown file is converted into a native Word table — separate cells, a header row, column alignment, and cell borders. The recipient can click into a cell and keep editing, add rows, and restyle the table with Word’s own table tools.

What happens to column alignment?

The alignment markers in the delimiter row (`:---`, `:---:`, `---:`) become cell alignment in the Word table, so a numbers column stays right-aligned and a header stays centred without retyping it.

Does this work without Pandoc?

Yes. Markwrite is a native Mac app: no Pandoc, no LaTeX, no command line and no reference template to maintain. Open the .md file and export the .docx.

Are there table features Markdown cannot express?

Merged cells, nested tables and multi-row headers have no syntax in standard Markdown (or GFM), so no converter can invent them from a .md file. Export gives you a clean grid of cells; finishing touches like merges are a one-minute job in Word afterwards.

Does the conversion upload my file anywhere?

No. Markwrite runs on your Mac and the conversion happens locally — nothing is uploaded, and it works offline. Drafts, contracts and internal notes stay on the machine.

Is there a free trial?

Yes — 14 days, and the trial is the full product with Word export included. After that it is a one-time purchase: no subscription, one license covers up to two Macs.