SuperAPI AI 工具集

baoyu-markdown-to-html

写作与研究

查看项目

更新于 10-16 06:44

技能介绍

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

主要能力:支持标题、粗体斜体、代码块语法高亮、行内代码、GFM 表格、图片、链接与脚注、引用块、列表、Alerts(如 > [!NOTE])、Ruby 注音、Mermaid 与 PlantUML 图表;支持 YAML frontmatter 元数据(title、author、description),无标题时从首个 H1/H2 或文件名提取。提供 default、grace、simple 三种主题。

使用方式:脚本入口为 ${SKILL_DIR}/scripts/main.ts。基本命令:npx -y bun ${SKILL_DIR}/scripts/main.ts <markdown_file> --theme <theme>。可选参数 --theme(default/grace/simple,默认 default)、--title 覆盖标题、--keep-title 保留首个标题(默认移除)、--help。输出与输入同目录的 .html 文件;若已存在同名 HTML 会先备份为 .bak-YYYYMMDDHHMMSS,并向 stdout 输出含 title、author、summary、htmlPath、backupPath、contentImages 的 JSON。

配置:可通过 EXTEND.md 自定义默认主题、CSS 变量与代码块样式,优先读取项目级 .baoyu-skills/baoyu-markdown-to-html/EXTEND.md,其次用户级 $HOME/.baoyu-skills/baoyu-markdown-to-html/EXTEND.md,未找到则用默认值。

限制:输入含中日韩文字时,若 baoyu-format-markdown 技能可用会询问是否先格式化;转换前会询问主题(除非已指定)。其余平台适配范围、收费与效果资料暂未提供。