Markdown flavors7 min read
CommonMark, GFM, and GitHub Extended: choose the right profile
A decision guide to Markdown flavors, extensions, and the compatibility checks that prevent rendering surprises.
Read guideMDLoom guides
Learn the decisions behind dependable Markdown.
Clear guidance for portable source, tables, links and assets, encoding, rich extensions, profile selection, composition, conversion, printing, and public publishing.
Guide quality standard
- ✓ Dated, version-aware guidance
- ✓ Concrete examples and explicit limitations
- ✓ Published and updated dates shown on each guide
01
Learn the foundationStart with portable syntax, clean outlines, durable links, images, code, and tables.
02
Choose a flavorUnderstand the boundary between CommonMark, formal GFM, and GitHub-style extras.
03
Ship a documentCompose sources, resolve assets, choose an output contract, and verify the artifact.
Library
Practical reference for real documents
Each guide is written for a concrete decision or workflow and links back to the product surface where you can apply it.
Publishing7 min read
Front matter for portable Markdown publishing
Define metadata ownership, merge policy, schemas, and destination mapping without leaking internal values into prose.
Read guideLearn Markdown8 min read
Markdown basics: a practical, portable foundation
Learn the small set of Markdown patterns that travel well between GitHub, documentation tools, and publishing workflows.
Read guideExtensions9 min read
Code, math, and Mermaid diagrams in Markdown
Use fenced code, bounded KaTeX, and isolated Mermaid rendering with explicit fallbacks and print review.
Read guideConvert8 min read
What Markdown conversion can—and cannot—preserve
Understand exact source, visual, structural, best-effort, and extractive conversion before choosing an output format.
Read guideTroubleshooting8 min read
Markdown encoding, BOM, and line-ending safety
Open UTF-8, UTF-16, and legacy text deliberately while preserving original bytes and avoiding invisible rewrites.
Read guideLearn Markdown7 min read
Markdown tables that stay readable and portable
Design, escape, review, and export GFM tables without hiding accessibility or destination limitations.
Read guideMulti-file Markdown9 min read
How to merge Markdown files without broken links or headings
Plan, reorder, and combine Markdown chapters while preserving sources and resolving cross-file references deliberately.
Read guidePublishing10 min read
How to print Markdown without layout surprises
Prepare tables, code, diagrams, fonts, page breaks, and metadata for a deterministic Markdown Print Proof and PDF.
Read guidePublishing9 min read
Publish Markdown safely for search and sharing
Create immutable public revisions, useful metadata, durable redirects, granular shares, and an abuse response boundary.
Read guidePortability8 min read
Portable relative links and images in Markdown
Keep paths, alternative text, assets, fragments, and privacy boundaries intact across repositories, bundles, merges, and publishing.
Read guideTroubleshooting10 min read
Troubleshoot Markdown rendering differences
Trace profile, source bytes, assets, renderer versions, extensions, and destination fidelity before editing around a symptom.
Read guideCoverage
From first heading to reviewed artifact
Basic syntaxTablesLinks and imagesCode, math, and diagramsMarkdown profilesMulti-file mergeRelative assetsFront matterEncoding and line endingsConversion fidelityPrint and PDFPublishing and SEOTroubleshooting