Documentation
¶
Overview ¶
md-html — exports `.md` files with ipmt embeds to static HTML.
Pipeline:
read config → resolve [[file]] / [[glob]] mappings
→ for each (src .md, out .html):
read markdown
inline ipmt code blocks (syntax-highlighted)
inline `<!-- ipm-svg --> ` pairs
rewrite relative .md links to .html
copy non-ipmt images to out_dir
wrap with page header + palette CSS
→ write
See pkg/mdhtml for the library; this binary is just the CLI shell.
Sibling to cmd/md-embed:
- md-embed refreshes on-disk SVGs + marker hashes (mutates the repo).
- md-html publishes those committed sources to static HTML (writes out_dir; never touches the source tree).
Future: vscode-ipm may grow "Watch _site" / "Refresh _site" commands that spawn this binary, for VS Code extension integration.
Click to show internal directories.
Click to hide internal directories.