SuperAPI AI 工具集

baoyu-markdown-to-html

前端与建站

查看项目

更新于 10-16 10:22

技能介绍

用途:把 Markdown 转换为内联样式的 HTML,优化用于微信公众号等平台发布。主题解析顺序为:用户显式指定的 --theme、本技能的 EXTEND.md 中 default_theme、baoyu-post-to-wechat 的 EXTEND.md、最后询问用户。可选主题有 default(经典)、grace(优雅)、simple(简洁)、modern(现代,配 --color red 可还原红金风)。若输入含中文字符且存在 baoyu-format-markdown 技能,会先询问是否格式化以修复加粗标记解析与中英文间距问题。

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

使用方式:基于 Bun 运行脚本,基本命令为 npx -y bun ${SKILL_DIR}/scripts/main.ts <markdown_file> --theme <theme>。常用选项包括 --theme、--color(预设名或 hex)、--font-family、--font-size、--title、--keep-title、--help。输出与输入同目录的 .html;若已存在同名 HTML 会先备份为 .bak-时间戳,并向 stdout 输出含标题、作者、摘要、htmlPath、backupPath 与本地图片占位信息的 JSON。

配置:通过 EXTEND.md 自定义默认主题、CSS 变量与代码块样式,优先项目级 .baoyu-skills/baoyu-markdown-to-html/EXTEND.md,其次用户级 $HOME 下同路径。

限制:资料未提供运行环境最低版本、许可证及具体平台兼容性细节。