宝玉转

文档 社区 v1.117.3

技能解读

baoyu-markdown-to-html 把 Markdown 转成「带内联样式的可发布 HTML」——重点不是简单转换,而是为公众号、博客这种不能加载外部 CSS 的平台优化。

核心痛点

微信公众号编辑器粘贴 HTML 时,会过滤掉 <link>、<style> 标签,所有样式必须 inline 在 style="" 属性里。手写这种 HTML 很痛苦。这个技能把所有样式 inline 化,粘贴进公众号编辑器后立刻就有样式。

工作流

按 Workflow 章节:① 读 Markdown 文件(含 frontmatter);② 选 Theme(多种预设,对应不同视觉风格);③ 处理 Supported Markdown Features:标题、列表、代码块、引用、表格、图片、链接,每一种都映射成带 inline 样式的 HTML 片段;④ 输出 .html 文件。

Frontmatter 处理

顶部 YAML frontmatter(title、author、cover、tags)会被解析并放进 HTML 顶部成可读的 banner。

Themes

内置多套主题,比如:

  • 简洁博客风(白底黑字 + 单一强调色)
  • 公众号经典风(青灰底 + 装饰边)
  • 暗色模式(深色底 + 高对比度)
  • 杂志风(衬线字体 + 大留白)

适合谁

  • 公众号长期作者,每周稳定产出
  • 博客作者,把 Markdown 同时发到博客、公众号、知乎
  • 知识星球 / 小报作者,需要带样式的发布版本
  • 想统一多平台视觉风格的内容运营

与 baoyu-format-markdown 配套

baoyu-format-markdown 把粗稿整理成结构良好的 Markdown,然后这个技能把它变成可发布 HTML。流程:粗稿 → baoyu-format-markdown → 干净 MD → baoyu-markdown-to-html → 公众号 HTML → 粘贴发布。

Extension Support

EXTEND.md 章节给了扩展点——你可以加自定义模板、改主题、接广告位 / 二维码自动插入。

不适合

需要复杂交互(按钮、表单、视频)的页面——这是文章排版器,不是建站器;需要响应式布局、暗色切换的现代网站——用 Astro / Hugo 这类 SSG。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
文档
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
92 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@JimLiu · v1.117.3 · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Bun
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第0步:预检查(中文内容)

条件:仅当输入文件包含中文文本时才执行。检测:读取输入markdown文件检查内容是否包含CJK字符(中文/日文/韩文)如果没有CJK内容→跳到步骤1

02
第一步:确定主题

主题解析顺序(第一个匹配获胜): 用户明确指定的主题(CLI `--theme` 或对话) EXTEND.md `default_theme`(该技能自己的 EXTEND.md,在步骤 0 中检查) `baoyu-post-to-wechat` EXTEND.md `default_theme`(跨技能回退)如果没有找到 → 使用 AskUserQuestion 确认

03
步骤1.5:确定引用模式

默认值:关闭。默认不询问。仅当用户明确要求“微信外链转底部引用”、“底部引用”、“文末引用”或通过`--cite`时才启用。启用时的行为:普通外部链接使用编号上标呈现,并收集在最终的`引用链接`部分下。 `https://mp.weixin.qq.com/...` 链接保留为直接链接,不会移至底部。

04
第三步:报告结果

显示 JSON 结果的输出路径。如果创建了备份,请提及。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。