Guides & Tutorials

How to use these guides

md2docx is intentionally simple: write Markdown, convert to DOCX, and review in Word. The details (tables, diagrams, templates, TOCs) are where most people lose time. These guides are designed to help you adopt a repeatable workflow instead of troubleshooting every document from scratch.

• If you’re converting AI drafts, start with ChatGPT → Word, then add Headings & TOC for structure.
• If you care about brand consistency, read Custom templates.
• If your documents are technical, add the “hard parts”: Tables, Mermaid, and Math.
• When you need fine-grained layout control (page breaks, sections, TOC), use Advanced options.

Ready to try a guide side-by-side with the converter? Open /convert in another tab and paste the examples as you read.

Recommended reading paths

AI-assisted drafting → stakeholder-ready DOCX

Use the model for structure and content, then let Word handle review. Focus on headings, tables, and a clean TOC.

• ChatGPT → Word
• Headings & TOC
• Custom templates

Engineering docs with diagrams

Keep diagrams as code so they can evolve with the architecture. Convert them into a shareable DOCX for stakeholders who live in Word.

• Mermaid diagrams
• Graphviz & PlantUML
• Advanced options

Reports with lots of data

Tables are where conversions usually fall apart. Keep tables simple and rely on Word’s native table tools after conversion.

• Mastering tables
• Custom templates

Common questions (fast answers)

“My document looks plain.”

Use a template. Markdown defines structure; templates define the look. If you convert without a template, you’ll still get a correct DOCX, but it may not match your organization’s typography and spacing. Start with Custom templates.

“My TOC is wrong.”

Make sure headings are used correctly (don’t skip levels), then update fields in Word after conversion. See Headings & TOC.

“My tables or diagrams don’t fit.”

Reduce width, split into smaller pieces, or use section breaks to create a landscape page for wide content. See Tables and Advanced options.

For known limitations and troubleshooting tips, visit Limitations.

Start converting (hands-on)

The fastest way to learn is to run one small conversion with a “kitchen sink” Markdown sample: a few headings, a table, a code block, and (optionally) a diagram or equation. Then iterate on structure and templates until you get a DOCX you’d feel comfortable sharing.

1. Open /convert and paste a short Markdown outline.
2. Enable a TOC if the document is long.
3. Try a sample template (or upload your own).
4. Download the DOCX and review headings, spacing, and tables.

If you want a deeper feature reference (supported Markdown, diagrams, math, options), see Docs.