Further Reading
A curated selection of tools, specifications, and books for writers who want to go further with Markdown and plain-text publishing. Specifications CommonMark — commonmark.org The definitive specification for Markdown. Readable, precise, and the basis for most modern Markdown implementations....
A curated selection of tools, specifications, and books for writers who want to go further with Markdown and plain-text publishing.
Specifications
CommonMark — commonmark.org The definitive specification for Markdown. Readable, precise, and the basis for most modern Markdown implementations. Essential reading if you want to understand why different tools render the same syntax differently.
GitHub Flavored Markdown — github.github.com/gfm The GFM specification. Documents every extension GitHub adds to CommonMark — tables, task lists, strikethrough, and fenced code blocks.
Tools
Pandoc — pandoc.org The universal document converter. Reads and writes dozens of formats. Powers the PDF and EPUB builds for this book. Indispensable for anyone publishing from Markdown.
Typst — typst.app A modern typesetting system designed as a replacement for LaTeX. Fast, clean syntax, excellent for producing print-quality PDFs from structured content.
Obsidian — obsidian.md A knowledge-management application built on Markdown files. Excellent for long-form writing, notes, and personal knowledge bases.
Zettlr — zettlr.com An open-source Markdown editor designed for academic and long-form writing. Supports Pandoc export, citations, and footnotes.
iA Writer — ia.net/writer A focused writing application with Markdown support across macOS, iOS, Windows, and Android. Minimal interface; good for distraction-free writing.
Books
'The Art of Plain Text Writing' A broad survey of the philosophy and practice of writing in plain-text formats. Covers Markdown, reStructuredText, and asciidoc.
'Producing Open Source Software' — Karl Fogel Not about Markdown specifically, but an excellent guide to writing documentation for technical projects. Free online at producingoss.com.
'Every Page Is Page One' — Mark Baker A book about structuring documentation for the web, where readers arrive at any page without reading sequentially. Challenges traditional book-structure thinking.
Communities
r/Markdown — reddit.com/r/Markdown A Reddit community for Markdown users — questions, tools, tips, and examples.
Pandoc mailing list — groups.google.com/g/pandoc-discuss The primary support and discussion forum for Pandoc users.