Agent skill · writing content · alirezarezvani
md-document
Use when converting long-form markdown (spec, RFC, report, plan) into a single-file HTML page with sticky TOC, search and code-copy. Parses with markdown_parser.py and renders with html_renderer.py using the design-system brand.
Why this skill is useful
Provides a specialized pipeline for converting markdown documents to interactive HTML, which includes specific commands and configurations not commonly known.
What it needs
Requires python3 installed locally. About 3k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
md-document — Long-form Markdown to HTML The general-purpose converter — handles the 90% case Shihipar describes (specs, plans, RFCs, reports, explainers). Three stdlib tools pipeline together: Output is one .html file with sticky TOC, search filter, scrollspy, code-copy buttons, and the user's 12 derived brand tokens. Externals limited to Google Fonts CSS + Prism.js CDN. When to invoke Symptom Action --- --- markdown-html-orchestrator routes input as DOCUMENT Invoke this skill User runs /cs-md-document <path>.md directly Invoke this skill User says "convert this spec/report/RFC/plan to HTML" Invoke this skill Input is a code review (has bash 1. Parse markdown → JSON AST python3 markdown-html/skills/md-document/scripts/markdownparser.py \ --input <path>.md --output sections.json 2. Render AST + design-system config → single-file HTML python3 markdown-html/skills/md-document/scripts/htmlrenderer.py \ --sections sections.json --output document.html 3. Inject lightweight JS (search, copycode, smoothscroll, scrollspy) python3 markdown-html/skills/md-document/scripts/interactivityinjector.py \ --file document.html \ --features search,copycode,smoothscroll,scrollspy bash python3 markdown-html/skills/md-document/scripts/htmlrenderer.py --sample \ python3 markdown-html/skills/md-document/scripts/interactivityinjector.py \ --file /dev/stdin --output document.html python ) with Prism.js highlighting on demand GFM tables with per-column alignment GFM callouts (> [!NOTE], > [!TIP], > [!IMPORTANT], > [!WARNING], > [!CAUTION]) Blockquotes, ordered + unordered lists (single-level), horizontal rules Out of scope: nested lists, HTML inlines, footnotes, definition lists, task list checkboxes (rendered as plain text), reference-style links. Hard rules 1. Refuses input < 100 lines. Markdown wins below the threshold (Shihipar). 2. Refuses without onboarding. configloader.setupcompleted() must return True. Otherwise surface /cs-design-system. 3. Single-file output. All CSS + JS inline. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/md-document--9fc78b