用途:把 Markdown 文件转换为带内联 CSS 的样式化 HTML,优化用于微信公众号等平台发布。
主要能力:支持标题、粗斜体、代码块(含语法高亮)、行内代码、GitHub 风格表格、图片、链接、引用、列表、Alerts(如 > [!NOTE])、脚注、Ruby 文本、Mermaid 与 PlantUML 图表,以及 YAML frontmatter(title、author、description)。提供 default、grace、simple、modern 四套主题,可指定预设颜色名或十六进制色值、字体、字号,并可覆盖标题。
使用方式:脚本入口为 scripts/main.ts,运行命令为 ${BUN_X} {baseDir}/scripts/main.ts <markdown_file> [options];${BUN_X} 在已安装 bun 时用 bun,否则用 npx -y bun,都没有则建议安装 bun。常用选项包括 --theme、--color、--font-family、--font-size、--title、--cite(将普通外链转为文末引用)、--keep-title、--help。输出与输入同目录的 .html,已存在时先备份为 .bak-YYYYMMDDHHMMSS,并向 stdout 输出含 htmlPath、backupPath 等信息的 JSON。
配置:可选 EXTEND.md 提供 default_theme、自定义 CSS 变量与代码块样式,按项目目录、XDG 配置目录、用户主目录顺序查找;主题优先级为用户显式指定、本技能 EXTEND.md、baoyu-post-to-wechat 的 EXTEND.md,均无则询问用户。
限制:中文内容仅作格式提示(可调用 baoyu-format-markdown 先格式化);外链转引用默认关闭;具体平台兼容效果与发布流程暂未提供。