用途:把 Markdown 文件转换为带内联 CSS 的样式化 HTML,主要面向微信公众号等平台排版。
主要能力:内置 default、grace、simple、modern 四种主题;支持标题、粗体/斜体、代码块高亮、行内代码、GFM 表格、图片、链接、引用、列表、Alerts、脚注、Ruby、frontmatter 等 Markdown 特性。Mermaid 代码块通过无头 Chrome(CDP)渲染为 PNG 并缓存于 imgs/.mermaid-cache/,支持 PlantUML。可用 --cite 把普通外链转为文末引用,mp.weixin.qq.com 链接保持不变。
用法:在技能目录下执行 ${BUN_X} {baseDir}/scripts/main.ts <markdown_file> [options]。常用选项有 --theme <name>、--color <name|hex>、--font-size、--title、--keep-title、--cite,以及 --mermaid-theme、--mermaid-scale、--mermaid-width、--mermaid-bg、--no-mermaid。默认删除首个标题,默认字号 16px,Mermaid 缩放 2、宽度 860、背景 white。颜色可选 blue、green、vermilion、yellow、purple、sky、rose、olive、black、gray、pink、red、orange 或自定义 hex。可通过项目、XDG 或用户目录下的 EXTEND.md 配置默认主题等。
输出:HTML 与输入文件同目录,同名 .html;若已存在会先备份为 .html.bak-YYYYMMDDHHMMSS,并向 stdout 输出包含标题、作者、摘要、htmlPath、backupPath 及图片信息的 JSON。
限制:Mermaid 渲染需系统安装 Chrome/Chromium/Edge,否则回退为 <pre class="mermaid">;运行时需 bun 或 npx。其他平台兼容性、收费与效果资料暂未提供。