markdown-to-html-reportlisted

# Markdown to Magazine-Grade HTML & PDF Reports ## Overview A high-aesthetic document compiler for AI Agents. It transforms dry Markdown into **comfortable, responsive, modern HTML5 reports** with soft shadows, sticky sidebar navigation, syntax-highlighted codeblocks, and automatic Mermaid diagram support, suitable for one-click PDF printing. ## When to Use & When NOT to Use ### When to Use - Compiling research briefs, system audit reports, and whitepapers into standalone HTML files. - Exporting client deliverables to high-resolution PDF via Headless Chromium. - Fixing Markdown table misalignment and embedding images as base64 for offline sharing. ### When NOT to Use - Generating simple raw terminal markdown or plain text logs. - Interactive multi-page web applications with complex client-side state. ## Core Compilation Workflow ```bash # Render markdown to standalone HTML with embedded images python3 scripts/render_report.py input.md output.html --embed-images --with-js # Verify image references and asset integrity python3 scripts/check_image_refs.py output.html ``` | Key CLI Options | Description | Default | |---|---|:---:| | `--embed-images` | Embeds local images as Base64 data URIs for single-file sharing | `True` | | `--with-js` | Adds reading progress bar, table-of-contents highlight, and back-to-top | `True` | | `--mermaid-source auto` | Automatically renders ````mermaid```` diagram blocks via CDN/local | `auto` | | `--title-style comfortable` | Clean magazine