Markdown Conversion Guides & Tutorials
Practical, tested walkthroughs for each MDTool converter, grouped by what you're converting.
Markdown to PDF
Getting code blocks, tables, and diagrams to survive the trip from Markdown to PDF. Try it with the Markdown to PDF converter.
Markdown to PDF with Python, Pandoc and Node
Convert Markdown to PDF in code: Pandoc with LaTeX or WeasyPrint, Python's md2pdf and markdown-pdf, Node's md-to-pdf.
Best Markdown to PDF Converter (2026 Guide)
An honest comparison of Markdown to PDF converters: MDTool, Dillinger, CloudConvert, markdowntopdf.com and Pandoc, including what each one can't do.
Download a GitHub README as PDF (3 Steps)
Download any GitHub README as a PDF in 3 steps: copy the raw Markdown, paste, download.
Why Markdown Tables Break in PDF Exports
Markdown tables are a common cause of broken PDF exports.
Markdown to PDF Code Blocks: Why They Break
Why code blocks break when you convert Markdown to PDF, and how to get syntax-highlighted code and rendered Mermaid diagrams in your PDF, free online.
Markdown to Word
Producing real, editable .docx files (and Google Docs) from Markdown. Try it with the Markdown to Word converter.
Markdown to Google Docs: 3 Ways That Work
Get Markdown into Google Docs with Paste from Markdown, a .md file import, or a .docx upload.
How to Convert a Markdown Resume to a Word Document
Write your resume in Markdown, keep it version-controlled, then convert it to a real Word document, with a copy-paste template included.
Markdown to DOCX: Real Word Files, Not HTML
Markdown to DOCX only converts cleanly when the output is genuine Office Open XML, not HTML wrapped in a Word shim.
Technical Documentation From Markdown to Word
Converting API docs and technical guides from Markdown to Word for stakeholder review?
Markdown to HTML
Converting Markdown to HTML for websites, email templates, and publishing platforms. Try it with the Markdown to HTML converter.
Markdown to Confluence and Jira: What Works
Get Markdown into Confluence and Jira: what the Cloud editor converts, Markdown macros, ADF explained, Jira wiki markup vs Markdown, and the HTML route.
How to Convert Markdown to HTML for Email Templates
Converting Markdown to HTML is step one.
Markdown to HTML: The Complete Conversion Guide
How Markdown to HTML conversion actually works, when to use snippet vs.
Markdown to HTML for Static Sites and Docs
Static site generators convert Markdown to HTML automatically at build time.
HTML to Markdown
Turning web pages, CMS exports, and messy WYSIWYG HTML into clean Markdown. Try it with the HTML to Markdown converter.
How to Convert Messy HTML to Clean Markdown
Word exports, Confluence pages and WYSIWYG editors produce HTML full of inline styles and nested divs.
How to Convert HTML to Markdown for CMS Migration
Migrating from WordPress or Confluence to Notion, Ghost, Astro or Hugo?
Converting HTML to Markdown for GitHub READMEs and Wikis
GitHub renders only a sanitized subset of HTML in READMEs and wikis.
Word to Markdown
Moving .docx and Google Docs content into Markdown for GitHub, docs sites, and note apps. Try it with the Word to Markdown converter.
Google Docs to Markdown: 4 Methods Compared
Convert Google Docs to Markdown with File → Download → Markdown, Copy as Markdown, the Docs to Markdown add-on, or a .docx export.
DOCX to Markdown: Convert Word Files Cleanly
Convert .docx Word files to clean Markdown: how mammoth.js reads the structure, how turndown writes GFM, and what to fix in the output before using it.
Word to Markdown for GitHub Docs: Free Converter
Moving Word content into a GitHub repo, wiki or static site?
How to Convert Word Documents to Markdown for Obsidian
Obsidian vaults store notes as plain .md files, but Word's .docx format can't open directly.
Tables & Excel
Building Markdown tables by hand or from spreadsheet data. Try it with the Markdown table generator.
Markdown basics
Creating, opening, and writing .md files, plus syntax references you can keep open while you work. For quick syntax lookups, see the Markdown cheat sheet.
How to Create a .md File on Windows, Mac and Linux
Create a Markdown (.md) file with Notepad, TextEdit, VS Code, Obsidian or one terminal command.
How to Open a .md File With Formatting
Open and view .md files formatted, not as raw symbols: VS Code preview, Obsidian, browser extensions, GitHub, or convert to PDF or Word for anyone else.
Markdown in VS Code: Preview, Shortcuts, Export
Use Markdown in VS Code: the built-in preview, keyboard shortcuts, the 3 extensions worth installing, exporting to PDF and Word, plus a syntax cheat sheet.
Printable Markdown Cheat Sheet (Free PDF)
A printable Markdown cheat sheet: every common syntax in compact tables, a free two-page PDF download, and the source to print your own in any theme.
README.md Cheat Sheet and Copy-Paste Template
A README.md cheat sheet: the sections every project needs, the GitHub Markdown syntax that matters (alerts, tables, Mermaid) and a full template to copy.
Guides in other languages
Markdown conversion guides written in German, Portuguese, French, Chinese and more. The tools themselves work the same in any language; there are also Spanish versions of the Word, PDF and Word to Markdown converters, and a 中文版 Markdown 转 Word converter.
Deutsch
- Excel-Tabelle in Markdown umwandeln · Excel-Tabelle in Markdown umwandeln: Zellen kopieren, im Generator einfügen, Spalten ausrichten
- HTML zu Markdown konvertieren: online & per CLI · HTML in Markdown umwandeln: Online-Konverter im Browser, was mit Tabellen, Links und Code passiert, unsauberes HTML bereinigen, plus pandoc und turndown.
- Markdown: Durchstreichen, Umbruch, Seitenumbruch · Markdown durchstreichen mit ~~Text~~, Zeilenumbruch per Leerzeichen, Backslash oder <br> und Seitenumbruch fürs PDF: alle Varianten mit Beispielen.
- Word zu Markdown: .docx umwandeln (auch Obsidian) · Word in Markdown umwandeln: .docx hochladen, .md herunterladen
Français
- Convertir un fichier Markdown (.md) en PDF · Passez un fichier .md en PDF dans le navigateur, sans installation ni envoi : thèmes, format A4, diagrammes Mermaid, sauts de page et alternatives.
- Convertir Markdown en Word (.docx) et inversement · Transformez un fichier .md en vrai document Word avec styles Titre 1, tableaux et listes, ou un .docx en Markdown propre : en ligne, Google Docs, Pandoc.
Português
- Checkbox em Markdown: sintaxe e atalhos · Como fazer checkbox em Markdown com - [ ] e - [x], onde funciona (GitHub, Obsidian, VS Code, Notion), atalhos de teclado e por que às vezes não aparece.
- Como converter Markdown em PDF: guia completo · Converta Markdown para PDF no navegador, sem instalar nada: temas, A4, diagramas Mermaid e quebra de página
- Converter Word para Markdown (.docx para .md) · Transforme um documento do Word em Markdown limpo, com títulos, listas, tabelas e links
Русский
- Как конвертировать Markdown в Word (.docx) · Как перевести Markdown в Word: пошаговая инструкция, настоящие стили «Заголовок 1–6», таблицы и списки в .docx, ограничения и альтернатива pandoc.
中文
- Markdown 转 Word：在线免费转换 · md 转 word 免费在线工具：在浏览器里把 Markdown 转成带“标题 1”样式的 .docx，也支持 Word 转 Markdown，文件不上传。