md-html
md-html: Markdown & HTML Directory Editor with Sync and Navigation
md-html renders all Markdown files in a directory into browser-editable HTML pages, and also wraps standalone .html files with a visual editor. A manager page with sidebar navigation lets you browse and edit all files. Support Mermaid render, zoom in/out, edge click interaction, and resizable table columns.
Key design principle: md produces, html consumes. All generated HTML files are placed in a dedicated md-html-manager/ subdirectory (under the user's specified directory), preserving the source directory's structure. The source .md files stay untouched in their original locations — only the md-html-manager/ directory contains generated output. Standalone .html files get editing wrappers in md-html-manager/_standalone/. After execution, the manager page auto-opens in the browser.
What to do
-
Identify the input — the user will provide either:
- A path to a
.mdfile → the skill uses that file's parent directory as the root and finds all.mdfiles in the directory tree - A path to a directory → the skill scans for all
.mdfiles in the directory and its subdirectories
- A path to a
-
Run the render script — execute
scripts/render_md_html.jswith the input path and optional parameters:node scripts/render_md_html.js <input.md-or-directory> [--output <manager-path>] [--port <port>] [--initial <relative-path>] [--no-server]