用途:把 Markdown 文件转换为带内联 CSS 样式的 HTML,便于发布到微信公众号等平台。
主要能力:支持标题、加粗斜体、代码块与语法高亮、行内代码、表格、图片、链接、引用、列表、Alerts、脚注、Ruby 注音、Mermaid 与 PlantUML 图表;支持 YAML frontmatter 读取标题、作者、摘要,未找到标题时回退到首个 H1/H2 或文件名。提供 default(经典)、grace(优雅)、simple(简洁)三种主题。
使用方式:通过脚本执行转换。 脚本位置:将 SKILL.md 所在目录视为 SKILL_DIR,使用 ${SKILL_DIR}/scripts/main.ts。 基本命令: npx -y bun ${SKILL_DIR}/scripts/main.ts <markdown_file> [options] 常用选项:--theme <name>(默认 default)、--title <title>、--keep-title、--help。默认会移除正文首个标题,加 --keep-title 保留。
输出:HTML 与输入文件同目录,若已存在会先备份为 .bak-YYYYMMDDHHMMSS;同时向 stdout 输出含 title、author、summary、htmlPath 等字段的 JSON。
偏好配置:可用 Bash 检查 EXTEND.md。项目级:test -f .baoyu-skills/baoyu-markdown-to-html/EXTEND.md && echo "project";用户级:test -f "$HOME/.baoyu-skills/baoyu-markdown-to-html/EXTEND.md" && echo "user"。存在则读取应用默认主题、自定义 CSS 变量、代码块样式等设置;不存在则用默认值。
流程:如输入含中日韩文字,会先检测,并在 baoyu-format-markdown 可用时询问是否先格式化;随后确认主题、执行转换并报告结果。
限制与说明:具体安装方式、运行环境依赖、价格与性能等资料暂未提供。