SuperAPI AI 工具集

baoyu-markdown-to-html

前端与建站

查看项目

更新于 10-16 08:48

技能介绍

用途:把 Markdown 文件转换为样式化 HTML,使用内联 CSS,重点适配微信公众号等平台排版。主要能力:内置 default、grace、simple、modern 四套主题;可指定主色(预设名或十六进制)、字体、字号、标题覆盖;支持标题、粗斜体、代码块高亮、行内代码、表格、图片、链接、引用、列表、Alerts 提示块、脚注、Ruby 注音、Mermaid 与 PlantUML 图;读取 YAML frontmatter 获取标题、作者、摘要。

用法:脚本入口为 scripts/main.ts,Agent 执行时先确定 SKILL.md 所在目录为 SKILL_DIR。基本命令:npx -y bun ${SKILL_DIR}/scripts/main.ts <markdown_file> --theme <theme>。常用选项含 --theme、--color、--font-family、--font-size、--title、--keep-title、--help。输出与输入 Markdown 同目录,生成同名 .html;若已存在则先备份为 .bak-YYYYMMDDHHMMSS,并以 JSON 打印标题、作者、摘要、htmlPath、backupPath 与内容图片占位信息。

配置:可用 EXTEND.md 覆盖默认主题、自定义 CSS 变量与代码块样式,优先检查项目级 .baoyu-skills/baoyu-markdown-to-html/EXTEND.md,其次用户级 $HOME/.baoyu-skills/baoyu-markdown-to-html/EXTEND.md;未找到则使用默认值。中文内容可先询问是否调用 baoyu-format-markdown 预处理。

限制:依赖 bun 运行时;主题未指定且 EXTEND.md 无 default_theme 时需用户确认;文中未提供平台发布、账号会话或抓取相关能力的具体步骤,相关事项暂未提供。