SuperAPI AI 工具集

baoyu-markdown-to-html

前端与建站

查看项目

更新于 10-15 21:56

技能介绍

用途:把 Markdown 文件转换为带内联 CSS 的样式化 HTML,面向微信公众号等平台排版。

主要能力:支持标题、粗斜体、代码块高亮、行内代码、GFM 表格、图片、链接、引用、列表、Alerts、脚注、Ruby 文本、Mermaid 与 PlantUML 图;支持 YAML frontmatter 元数据。Mermaid 代码块经无头 Chrome(CDP)渲染为 PNG 并缓存于 imgs/.mermaid-cache/,缓存键含代码、主题、缩放、宽度、背景与版本;无 Chrome 时回退为 <pre class="mermaid">。

使用方式:脚本入口为 scripts/main.ts,需 Bun 或 npx。基本命令:${BUN_X} {baseDir}/scripts/main.ts <markdown_file> [options]。常用选项:--theme(default、grace、simple、modern)、--color、--font-family、--font-size、--title、--cite、--keep-title、--mermaid-theme、--mermaid-scale、--mermaid-width、--mermaid-bg、--no-mermaid、--help。输出与输入同目录,同名 HTML 已存在时先备份为 .bak-时间戳,并向 stdout 输出 JSON(含 htmlPath、backupPath、contentImages、mermaidImages 等)。

配置:按优先级读取 EXTEND.md(项目 .baoyu-skills/、XDG、用户主目录),可设默认主题、CSS 变量、代码块样式与 Mermaid 默认值;无则用默认值。中文内容可先经 baoyu-format-markdown 格式化。

限制:Mermaid 渲染依赖系统 Chrome/Chromium/Edge;--cite 默认关闭,仅显式请求时启用。其余细节资料未提供。