forge-mdlisted

Render existing markdown files to themed self-contained HTML — single-file preview or multi-tab combined doc. Use when the user has finished markdown and just wants it rendered as-is (no tab planning, no rewriting). Triggers: "render md" | "render markdown" | "md to html" | "tabbed docs" | "combine markdown" | "preview md" | "forge md" | "render this folder" | "make a tabbed doc from these md files".
Roxabi/roxabi-forge · ★ 2 · Data & Documents · score 71

Install: claude install-skill Roxabi/roxabi-forge

# Forge MD — Render Markdown As-Is Thin wrapper around `render-md.py` (single file) and `render-md-tabs.py` (multi-file tabbed). Use when the user has already authored markdown and wants it rendered — **do not rewrite, restructure, or plan tabs**. The scripts handle sorting, tab labels, tables, task lists, and the roxabi dark aesthetic. **No diagram runtime:** Mermaid-style fenced diagram blocks are not supported. The render scripts emit an error to stderr and exit non-zero when they encounter a legacy diagram fence. For diagrams, author a native fgraph template under `plugins/forge/references/graph-templates/` (see `graph-templates/README.md`) and reference its output path from the markdown, or switch to `forge-guide` for a multi-tab doc with inline diagrams. ## When to use this skill vs. others | User has | Use | |---|---| | Finished `.md` files, wants HTML preview | **forge-md** (this) | | Idea/topic, wants a multi-tab HTML doc designed from scratch | `forge-guide` | | Slide deck from markdown | `forge-slides` | | Single chart/diagram | `forge-chart` | If unsure: existing markdown on disk → this skill; "write me a guide about X" → `forge-guide`. ## Scripts Located in this repo at `~/projects/roxabi-forge/scripts/` and deployed to `$FORGE_DIR/scripts/` via `make -C plugins/forge deploy`. ``` scripts/render-md.py single .md → <input>.preview.html (self-contained) scripts/render-md-tabs.py N × .md → one tabbed HTML with URL-hash deep links ``` Both are `uv r