用途:将 Markdown 文件转换为带内联 CSS 的精美 HTML,针对微信公众号等平台做兼容优化,输出文件与输入 Markdown 位于同一目录。
主要能力:支持标题、粗体/斜体、带语法高亮的代码块、行内代码、GitHub 风格表格、图片、链接与脚注引用、引用块、列表、提示框(如 > [!NOTE]、> [!WARNING])、脚注、Ruby 文本、Mermaid 与 PlantUML 图;支持 YAML frontmatter 元数据,未找到标题时从首个 H1/H2 或文件名提取。
主要用法:Agent 执行时以本 SKILL.md 所在目录为 SKILL_DIR,调用 ${SKILL_DIR}/scripts/main.ts。命令示例:npx -y bun ${SKILL_DIR}/scripts/main.ts <markdown_file> --theme <theme>。常用选项:--theme(default、grace、simple、modern)、--color(预设名或十六进制,如 blue、red、orange)、--font-family、--font-size(14-18px)、--title、--keep-title、--help。
可选偏好:可通过 EXTEND.md 配置默认主题、自定义 CSS 变量与代码块样式,查找顺序为先项目级 .tuzi-skills/tuzi-markdown-to-html/EXTEND.md,再用户级 $HOME/.tuzi-skills/tuzi-markdown-to-html/EXTEND.md;未找到则用默认值。若本技能未设 default_theme,可回退检查 tuzi-post-to-wechat 的 EXTEND.md。
中文内容预检查:仅当输入含中日韩字符时执行,可询问是否先用 tuzi-format-markdown 格式化,以修复中英混排加粗标记解析失败等问题;用户拒绝则继续用原文件。
输出:生成同名 .html 文件,冲突时先备份为 article.html.bak-YYYYMMDDHHMMSS,并向 stdout 输出 JSON,含 title、author、summary、htmlPath、backupPath、contentImages 等字段。
限制:价格、平台支持范围等未提供,暂未说明其他限制。