markdown-html-orchestrator

Run the orchestrator on your markdown file; it classifies the document type and routes to the md-document, md-review, or md-slides converter, which writes one self-contained HTML file with inline CSS and JavaScript. The design-system onboarding must be completed first.

The doctype_classifier.py script scores filename hints (2 points each) and content signals like diff fences, slide boundaries, and table rows (1-2 points each). It routes silently when the winner scores 3 or more and doubles the runner-up, otherwise it asks one clarifying question.

Conversion is refused when input is under 100 lines, based on the threshold that markdown remains the better format below that length. The classifier reports below_min_lines and the route explainer refuses before routing.

No. The orchestrator refuses if the design-system config at ~/.config/markdown-html/design-system.json is missing or lacks setup_completed_at. Run onboard.py once, or use --defaults for a zero-touch setup.

Only Google Fonts CSS and Prism.js from CDN are permitted; everything else is inlined into the single HTML file. Both degrade gracefully to system fonts and plain pre blocks if the CDN is blocked.

The output path resolver suffixes the filename with -2, -3, and so on by default. You can opt into timestamped names or explicit overwrite with the --on-collision flag; silent overwrites never happen.