How do I export Markdown to Word or PDF?

Use the 'Download DOCX' or 'Download PDF' buttons on any guide page. The conversion preserves tables, Mermaid diagrams, and formatting.

Can I customize the Markdown content before exporting?

Yes! Click 'Start Editing' to open the content in our editor, make changes, then export your customized version.

Does this support GitHub Flavored Markdown?

Yes, all guides support CommonMark plus GitHub Flavored Markdown extensions including tables, task lists, footnotes, and strikethrough text.

Are Mermaid diagrams and math formulas supported?

Yes! Mermaid diagrams and LaTeX math formulas are rendered properly and converted to images or formatted correctly in exported documents.

Markdown Table – Alignment, Formatting, and Conversion (GFM)

Everything about Markdown tables: syntax, alignment, header rows, multi-line cells, code in cells, images/links, CSV/Excel ⇄ Markdown. Try our live editor for perfect Word/PDF export with copy-ready examples.

↔️ Alignment Support

📊 CSV Conversion

🔗 Links & Images

📱 Platform Ready

🔄 CSV ↔ Markdown Converter

Convert between CSV/Excel data and Markdown table format instantly.

💡 How to use:

• CSV → Markdown: Enter CSV data in the left field and click "CSV → Markdown"
• Markdown → CSV: Enter Markdown table data in the right field and click "Markdown → CSV"
• Copy: Use the "📋 Copy Markdown" button to copy the converted table
• Clear: Use the "Clear" button to reset both fields

CSV Data

Markdown Table Data

Markdown Table Guide (GFM)

A complete guide to Markdown tables that actually works in real documents. Covers GitHub-Flavored Markdown (GFM) syntax, alignment, links/images/code inside cells, multi-line cells, and conversions between CSV/Excel ⇄ Markdown.

Tip: Use our Try Tables in Editor button to create perfect tables with live preview, then export DOCX/PDF with real Word tables (borders & alignment preserved).

Basic Syntax
Alignment
Links, Images, Code in Cells
Multi-line Cells
Column Width & Wrapping
CSV / Excel ⇄ Markdown
HTML Table (when Markdown falls short)
Platform Differences
FAQ

Basic Syntax

| Feature | Supported? |
|--------|------------|
| Tables | ✅         |
| Alignment | ✅      |

First row is the header.
Second row of dashes defines the table and supports alignment markers.

Alignment

| Left | Center | Right |
|:-----|:------:|------:|
| a    |   b    |     c |

:--- = left, :---: = center, ---: = right.

Links, Images, Code in Cells

| Type   | Example                         |
|--------|---------------------------------|
| Link   | [md2word](https://md2word.com)  |
| Image  | ![alt](https://example.com/i.png) |
| Code   | `inline code`                   |

Block-level elements (lists, blockquotes) are not reliably supported inside cells across parsers—prefer concise content per cell.

Multi-line Cells

CommonMark itself doesn’t support hard line breaks within a cell, but many renderers accept <br>:

| Feature | Note                    |
|--------|--------------------------|
| Lines  | Line1<br>Line2<br>Line3 |

For longer content, consider split rows or switch to HTML table for precise layout.

Column Width & Wrapping

Markdown has no native column width control. Use CSS/HTML if you need fixed widths.
When exporting via md2word, columns auto-fit like Word tables and keep alignment/borders.

CSV / Excel ⇄ Markdown

CSV → Markdown

Paste CSV into the converter.
Choose “CSV → Markdown table”.
Adjust alignment; copy or export to DOCX/PDF.

Markdown → CSV/Excel

Export the detected table as CSV or .xlsx for spreadsheet editing.

Example CSV:

Name,Score,Passed
Alice,92,TRUE
Bob,78,TRUE
Cara,63,FALSE

Converted Markdown:

| Name  | Score | Passed |
|-------|------:|:------:|
| Alice |    92 |  ✅    |
| Bob   |    78 |  ✅    |
| Cara  |    63 |  ❌    |

HTML Table (when Markdown falls short)

Use HTML when you need rowspan/colspan, precise widths, or nested content:

<table>
  <thead>
    <tr><th>Quarter</th><th colspan="2">Revenue</th></tr>
  </thead>
  <tbody>
    <tr><td>Q1</td><td>$1.2M</td><td>$1.4M</td></tr>
  </tbody>
</table>

md2word converts HTML tables into true Word tables with merged cells.

Platform Differences

Platform	Tables	Alignment	Notes
GitHub (GFM)	✅	✅	Most common; no colspan/rowspan
Obsidian	✅	✅	Works in preview; exports vary by plugin
Notion	⚠️	⚠️	Imports Markdown but uses native tables
Discord/Reddit	⚠️	⚠️	Limited or none; consider screenshots/code blocks

FAQ

Q: Why are my columns misaligned in plain text editors?
Spaces are cosmetic. Rendering engines ignore them; use alignment markers in the header row.

Q: Can I merge cells?
Not in pure Markdown. Use HTML tables for rowspan/colspan or restructure data.

Q: My table breaks in Word after copy-paste
Use md2word export to get a proper DOCX table with consistent borders and alignment.

Q: How big can a table be?
Markdown parsers handle large tables, but browsers slow down. Consider chunking or switching to CSV/Excel for editing, then re-export.

Changelog

2025-10-13: Initial release with CSV/Excel round-trip and HTML fallback guidance.

Next steps:

Try Tables in Editor to create your own tables with live preview and export.
Explore related docs: Markdown Cheat Sheet, Markdown Hyperlink, Markdown to PDF.

Frequently Asked Questions

How do I align columns in Markdown tables?

Use colons in the separator row: `:---` for left, `:---:` for center, and `---:` for right alignment. Check the "Alignment" section above for examples.

Can I merge cells in Markdown tables?

Standard Markdown doesn't support merged cells. For complex tables with merged cells, use HTML tables as shown in the "HTML Table" section.

How do I convert Excel data to Markdown?

Export Excel as CSV, then use the CSV → Markdown converter above. Or copy-paste directly into our editor and export as Word/PDF.

Why do my tables look different in various platforms?

Different platforms have varying Markdown support. See the "Platform Differences" section for compatibility details with GitHub, Obsidian, Notion, and others.

<h1>Markdown Table Guide (GFM)</h1>
<p>A complete guide to <strong>Markdown tables</strong> that actually works in real documents. Covers <strong>GitHub-Flavored Markdown (GFM)</strong> syntax, alignment, links/images/code inside cells, multi-line cells, and conversions between <strong>CSV/Excel ⇄ Markdown</strong>.</p>
<blockquote>
<p>Tip: Use our <strong>Try Tables in Editor</strong> button to create perfect tables with live preview, then export <strong>DOCX/PDF</strong> with real Word tables (borders & alignment preserved).</p>
</blockquote>
<hr />
<h2>Table of Contents</h2>
<ul>
<li><a href="#basic-syntax">Basic Syntax</a></li>
<li><a href="#alignment">Alignment</a></li>
<li><a href="#links-images-code-in-cells">Links, Images, Code in Cells</a></li>
<li><a href="#multi-line-cells">Multi-line Cells</a></li>
<li><a href="#column-width--wrapping">Column Width & Wrapping</a></li>
<li><a href="#csv--excel--markdown">CSV / Excel ⇄ Markdown</a></li>
<li><a href="#html-table-when-markdown-falls-short">HTML Table (when Markdown falls short)</a></li>
<li><a href="#platform-differences">Platform Differences</a></li>
<li><a href="#faq">FAQ</a></li>
</ul>
<hr />
<h2>Basic Syntax</h2>
<pre><code>| Feature | Supported? |
|--------|------------|
| Tables | ✅         |
| Alignment | ✅      |
</code></pre>
<ul>
<li>First row is the <strong>header</strong>.</li>
<li>Second row of dashes defines the table and supports alignment markers.</li>
</ul>
<hr />
<h2>Alignment</h2>
<pre><code>| Left | Center | Right |
|:-----|:------:|------:|
| a    |   b    |     c |
</code></pre>
<ul>
<li><code>:---</code> = left, <code>:---:</code> = center, <code>---:</code> = right.</li>
</ul>
<hr />
<h2>Links, Images, Code in Cells</h2>
<pre><code>| Type   | Example                         |
|--------|---------------------------------|
| Link   | [md2word](https://md2word.com)  |
| Image  | ![alt](https://example.com/i.png) |
| Code   | `inline code`                   |
</code></pre>
<blockquote>
<p>Block-level elements (lists, blockquotes) are not reliably supported inside cells across parsers—prefer concise content per cell.</p>
</blockquote>
<hr />
<h2>Multi-line Cells</h2>
<p><strong>CommonMark</strong> itself doesn’t support hard line breaks within a cell, but many renderers accept <code><br></code>:</p>
<pre><code>| Feature | Note                    |
|--------|--------------------------|
| Lines  | Line1<br>Line2<br>Line3 |
</code></pre>
<p>For longer content, consider split rows or switch to <strong>HTML table</strong> for precise layout.</p>
<hr />
<h2>Column Width & Wrapping</h2>
<p>Markdown has no native column width control. Use CSS/HTML if you need fixed widths.<br />
When exporting via <strong>md2word</strong>, columns auto-fit like Word tables and keep alignment/borders.</p>
<hr />
<h2>CSV / Excel ⇄ Markdown</h2>
<p><strong>CSV → Markdown</strong></p>
<ol>
<li>Paste CSV into the converter.</li>
<li>Choose <strong>“CSV → Markdown table”</strong>.</li>
<li>Adjust alignment; copy or export to <strong>DOCX/PDF</strong>.</li>
</ol>
<p><strong>Markdown → CSV/Excel</strong></p>
<ul>
<li>Export the detected table as <strong>CSV</strong> or <strong>.xlsx</strong> for spreadsheet editing.</li>
</ul>
<p>Example CSV:</p>
<pre><code>Name,Score,Passed
Alice,92,TRUE
Bob,78,TRUE
Cara,63,FALSE
</code></pre>
<p>Converted Markdown:</p>
<pre><code>| Name  | Score | Passed |
|-------|------:|:------:|
| Alice |    92 |  ✅    |
| Bob   |    78 |  ✅    |
| Cara  |    63 |  ❌    |
</code></pre>
<hr />
<h2>HTML Table (when Markdown falls short)</h2>
<p>Use HTML when you need <strong>rowspan/colspan</strong>, precise widths, or nested content:</p>
<pre><code class="language-html"><table>
  <thead>
    <tr><th>Quarter</th><th colspan="2">Revenue</th></tr>
  </thead>
  <tbody>
    <tr><td>Q1</td><td>$1.2M</td><td>$1.4M</td></tr>
  </tbody>
</table>
</code></pre>
<blockquote>
<p>md2word converts HTML tables into true Word tables with merged cells.</p>
</blockquote>
<hr />
<h2>Platform Differences</h2>
<table>
<thead>
<tr>
  <th>Platform</th>
  <th style="text-align:center">Tables</th>
  <th style="text-align:center">Alignment</th>
  <th>Notes</th>
</tr>
</thead>
<tbody>
<tr>
  <td>GitHub (GFM)</td>
  <td style="text-align:center">✅</td>
  <td style="text-align:center">✅</td>
  <td>Most common; no colspan/rowspan</td>
</tr>
<tr>
  <td>Obsidian</td>
  <td style="text-align:center">✅</td>
  <td style="text-align:center">✅</td>
  <td>Works in preview; exports vary by plugin</td>
</tr>
<tr>
  <td>Notion</td>
  <td style="text-align:center">⚠️</td>
  <td style="text-align:center">⚠️</td>
  <td>Imports Markdown but uses native tables</td>
</tr>
<tr>
  <td>Discord/Reddit</td>
  <td style="text-align:center">⚠️</td>
  <td style="text-align:center">⚠️</td>
  <td>Limited or none; consider screenshots/code blocks</td>
</tr>
</tbody>
</table>
<hr />
<h2>FAQ</h2>
<p><strong>Q: Why are my columns misaligned in plain text editors?</strong><br />
Spaces are cosmetic. Rendering engines ignore them; use alignment markers in the header row.</p>
<p><strong>Q: Can I merge cells?</strong><br />
Not in pure Markdown. Use <strong>HTML tables</strong> for <code>rowspan/colspan</code> or restructure data.</p>
<p><strong>Q: My table breaks in Word after copy-paste</strong><br />
Use <strong>md2word export</strong> to get a proper DOCX table with consistent borders and alignment.</p>
<p><strong>Q: How big can a table be?</strong><br />
Markdown parsers handle large tables, but browsers slow down. Consider chunking or switching to CSV/Excel for editing, then re-export.</p>
<hr />
<h3>Changelog</h3>
<ul>
<li>2025-10-13: Initial release with CSV/Excel round-trip and HTML fallback guidance.</li>
</ul>
<hr />
<p><strong>Next steps</strong>:</p>
<ul>
<li><strong>Try Tables in Editor</strong> to create your own tables with live preview and export.</li>
<li>Explore related docs: <a href="/markdown-cheat-sheet">Markdown Cheat Sheet</a>, <a href="/markdown-hyperlink">Markdown Hyperlink</a>, <a href="/markdown-to-pdf">Markdown to PDF</a>.</li>
</ul>