Agent skill · writing content · borghei
md-document
Convert authored markdown into a polished self-contained HTML document with a table of contents, numbered figures and tables, cross-references, footnotes, and print-ready CSS. Use when publishing a report, whitepaper, or memo.
Why this skill is useful
Adds specific scripts for cross-reference auditing and markdown to HTML conversion that are not commonly known.
What it needs
Requires python3 installed locally. About 7k tokens when loaded. Last updated 2026-07-21. 462 stars on the source repository.
What this skill does
Markdown Document Publishing Turn an authored markdown file into a single HTML document you can email, host, or print — semantic structure, an automatic table of contents, figures and tables numbered and referenceable by number, footnotes, and a print stylesheet that survives contact with a PDF exporter. One file out, no runtime dependencies, no external assets. When to use this skill Publishing a report or whitepaper that must arrive as one file, not a folder Producing a PDF from markdown without a LaTeX or Pandoc toolchain Numbering figures and tables so prose can reference them instead of saying "below" Converting untrusted or contributed markdown where injection safety matters Standardizing a document series so every issue looks like the same publication Catching broken cross-references before a document reaches readers Inputs the skill expects A markdown source file, optionally with YAML frontmatter Figure images as relative paths (or data URIs, for true single-file output) The intended output: screen, print, or both Document length and whether a table of contents is warranted Page geometry, if printing: size, margins, single- or double-sided A stylesheet, if not using the bundled theme Clarify First Before converting, confirm these inputs. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills borghei/md-document