Markdown Preview — Live Markdown to HTML

Markdown syntax errors — unclosed fences, wrong heading level — show immediately in rendered output instead of after git push to docs site. Authors catch broken lists and empty links before review.

Split-pane editing mirrors VS Code and Typora UX without installing desktop apps on locked-down corporate laptops.

ATX headings with hash prefixes, paragraph text separated by blank lines, emphasis with asterisks or underscores, and links with bracket paren syntax render in the preview pane.

Fenced triple-backtick code blocks preserve language tags visually even when syntax highlighting is minimal — enough to verify fence pairing.

Heading hierarchy visualizes document outline for README and ADR structure review. Nested unordered and ordered lists indent in preview matching source indent conventions.

Code blocks display monospace for CLI examples, JSON samples, and curl commands — pair with json-formatter-validator on extracted JSON from fences separately.

Security runbooks and unreleased feature docs render locally. No server-side Markdown storage for preview generation.

Sanitized HTML output reduces XSS risk when preview HTML is copied into WYSIWYG editors — still verify target platform policies.

Hugo, Jekyll, and Eleventy accept Markdown content — preview here before commit when CI build is slow. Front matter YAML blocks may show literally unless stripped manually.

Use yaml-formatter on front matter separately when metadata indent breaks.

When embedding preview HTML fragments into templates, encode entities with html-encoder-decoder if inserting into attributes. Markdown preview outputs body HTML, not full documents with doctype.

Raw HTML passthrough in Markdown may strip for safety — use native Markdown constructs when possible.

GitHub Flavored Markdown adds tables, task lists, and autolinks. This preview targets portable basic Markdown — verify GFM-specific syntax on GitHub before relying on local render.

GitHub preview requires push or gist — this page works offline after load on airplane drafts.

Architecture Decision Records use heading levels and bullet tradeoffs — preview confirms structure before PR to docs repo.

Issue templates with Markdown sections preview checkbox and bold instruction text for contributor clarity.

Separate paragraphs with blank lines — single newlines often join lines in Markdown parsers. Close code fences with matching backtick count.

Escape literal asterisks when needed or use code spans for star characters in prose.

word-counter measures source including markup characters — compare visible length by rough estimate or strip syntax manually.

slug-generator builds URL from title while Markdown holds body — standard blog publishing chain.