用途:把 Markdown 文件转换为带内联 CSS 的样式化 HTML,面向微信公众号等平台。
主要能力:内置 default、grace、simple、modern 四套主题;支持标题、粗斜体、代码块语法高亮、行内代码、GFM 表格、图片、链接、引用、列表、Alerts、脚注、Ruby 注音、Mermaid 与 PlantUML。Mermaid 代码块经无头 Chrome(CDP)渲染为 PNG 并缓存于 imgs/.mermaid-cache/,缓存键包含代码、主题、缩放、目标宽度、背景与 Mermaid 版本;无 Chrome 时回退为 <pre class="mermaid">。
使用方式:脚本入口为 scripts/main.ts,用 Bun 或 npx -y bun 运行: ${BUN_X} {baseDir}/scripts/main.ts <markdown_file> [options] 常用选项:--theme、--color、--font-family、--font-size、--title、--cite、--keep-title、--mermaid-theme、--mermaid-scale、--mermaid-width、--mermaid-bg、--no-mermaid、--help。输出与输入同目录,同名 HTML 已存在时先备份为 .bak-时间戳,并以 JSON 打印标题、作者、摘要、htmlPath、backupPath 等。可通过 EXTEND.md 配置默认主题、CSS 变量、代码块样式与 Mermaid 默认值,查找优先级为项目 .baoyu-skills/、XDG 配置目录、用户主目录。
适用场景:需将中文 Markdown 文章发布到公众号等平台并保持排版样式。输入含中日韩字符时,若 baoyu-format-markdown 可用会先询问是否格式化;主题按用户指定、本技能 EXTEND.md、baoyu-post-to-wechat EXTEND.md 顺序解析,均无则询问;--cite 默认关闭。
限制:需 Bun 或 npx 环境;Mermaid 渲染需系统安装 Chrome/Chromium/Edge。收费、价格暂未提供。