话术 md-html 出版流水线
以 md 为源代码的多格式出版流水线：万物转干净 md，md 出出版级 html、docx、PDF、EPUB，内置反 AI slop 审美底线。
文档层面未发现红线风险：无凭据窃取、无隐蔽外传；OPENAI_API_KEY 为可选且用途披露（图片描述）；版本自检声明不主动执行更新、由用户决定，属良好确认设计。但实际脚本未在本次证据中提供，无法静态核实最小权限、数据流与回滚；git ls-remote 联网检查在文档中是静默的。扣分：脚本本体缺失导致权限/隔离/回滚不可核实。
SKILL.md 异常处理表详尽（依赖缺失提示、空输出告警、macOS pip/python3 陷阱、EPUB 已知坑），路径自洽、依赖说明清晰。但六个入口脚本与 references 均未在证据中出现，无测试、无 CI、无复现记录，静态评估封顶 10。扣分：关键路径不可静态复现，失败反馈质量仅有文档自述。
决策树、URL 双路径分流（读/查捷径）、与其他 skill 的边界声明、触发语句表格都非常清晰，中文场景原生支持。扣分：部分功能（YouTube 字幕、部分 URL 抓取）依赖大陆网络可能不可达的资源，文档仅以「检查网络/VPN/CDN」一笔带过；环境验证证据有限。
文档分层良好（决策树→能力详解→references 路由→异常表），MIT 许可证齐全，依赖与安装说明明确。但存在文档不一致：SKILL.md 称六个能力而 README 称四个（能力 5/6 未在 README 结构图中列出，templates 树也只列四套加 wechat）；无 CHANGELOG/版本号体系，维护责任仅靠 README 个人介绍。扣分：版本治理与文档间一致性不足。
自述一条命令完成 PDF→md→精美 html/docx/epub 流水线，并给出 158 页出版社审校稿实战案例，边际价值（对比 pandoc 直出）论证充分。但所有产出均为自述，静态读取无法验证输出直接可用；示例输出文件未在证据中出现。扣分：缺乏可核验的代表性产出。
有第一手材料的迹象（详细异常表、踩坑记录、命名的实战案例），但均不可独立复核；无测试套件、无 CI、无第三方执行证据，示例输出与 references 未在本次证据中呈现。扣分：证据类型单一且全为作者自述。
- 六个入口脚本（any_to_md.py 等）与 references/examples 未在本次证据中出现，安装前建议自行审查脚本的网络请求与文件写入行为。
- SKILL.md 与 README 能力数量不一致（六 vs 四），实际可用能力以仓库内脚本为准。
- URL 抓取与 YouTube 字幕功能在大陆网络环境下可能不可达，文档仅提示用 VPN，未提供替代方案。
- 能力 1 的 --llm-describe 需 OPENAI_API_KEY，会把图片内容发送给第三方 API，敏感图片慎用。
- 依赖较重（markitdown[all]、pandoc、playwright+chromium 等），首次安装体积与时间成本较高。
- 无测试与 CI 证据，转换质量（尤其复杂表格、扫描 PDF）按文档自述存在已知缺陷。
这个 Skill 能做什么，适合哪些场景？
huashu-md-html 是一个 Agent Skill，把 markdown 当作中心源代码，打通任意文件到 md、md 到精美产物的双向流水线。六个能力分别封装成单条 Python 命令：任意文件（PDF/DOCX/PPTX/XLSX/图片/音频/URL）转 md、md 转 html、html/URL 转 md、md 转出版社级 docx、md 转多规格 PDF、md 转 EPUB3。html 路线提供 4 套自包含主题（article/report/reading/interactive），并继承自 huashu-design 的反 AI slop 审美清单。依赖 pandoc、markitdown、html-to-markdown、trafilatura 等外部工具，脚本启动时自检并提示安装。
运行 scripts/ 下的六个 Python 脚本：any_to_md.py 封装 markitdown，把 PDF、DOCX、PPTX、XLSX、图片、音频、YouTube URL、普通网页等 20+ 格式转成 md（URL 可带 YAML frontmatter）；md_to_html.py 封装 pandoc 加 4 套自调 CSS 模板，产出 html，另有耗 token 的设计师模式由 AI 推荐三个视觉方向；html_to_md.py 封装 html-to-markdown 与 trafilatura，做本地 html 或博客 URL 的正文提取归档；md_to_docx.py 用 python-docx 直出出版社级 docx，支持多文件合并、书籍模式（封面/目录/页眉页脚）、大 32 开或 A4 页面；md_to_pdf.py 走 md→html→Playwright/Chromium 两步出 PDF，支持 A4/A5/大 32 开/Letter/Legal；md_to_epub.py 用 pandoc + ebooklib 产出 EPUB3，含自动嵌图、按 H1 切章、EPUB 兼容 CSS。
- 写作者/博主想把 PDF 白皮书或 YouTube 视频内容转成 md，再一键渲染成可发布的精美网页
- 出书作者要把多章 md 打成出版社可审校的 docx 投稿稿（源文档实测生成过 158 页、9 章 + 后记 + 附录、57 张配图的审校稿）
- 独立开发者想归档已发布的博客文章或抓取产品页/技术文档回项目 md 源
- 内容创作者要把文章做成 A4 分享 PDF、大 32 开纸质书预览或 Apple Books/Kindle 可读的 EPUB
- 面对不确定的 URL 时想对比 markitdown（保结构化字段）与 trafilatura（纯正文去噪）两种提取结果再选
这个 Skill 有哪些优点和局限？
- 六个能力各封装成一条命令，能力 1 产出可直接喂给能力 2/5/6 组成一条龙（如 PDF→md→精美 html 或重新打版 PDF）
- 4 套 html 主题自包含单 CSS、无外部 CDN，且过了反 AI slop 清单（无紫渐变、无 emoji 图标、无 #0D1117 深蓝底）
- docx 能力内置出版社级排版预设（章号小标、按 emoji 配色引用块、页眉页脚、大 32 开/A4），有 158 页实体书审校稿的实战验证
- URL 输入提供了明确分流策略：结构化页面走 markitdown 保 metadata，正文页面走 trafilatura 去噪，不确定就两个都跑对比
- 脚本启动自检依赖，缺失时给出明确安装命令而非静默失败
- 依赖链较重：pandoc（brew）、多个 pip 包，PDF 还需下载 Chromium
- 已知局限明确：扫描 PDF 不做 OCR、复杂表格丢语义、PPTX 只保文本+备注、markitdown 输出为 LLM 消费设计给人读还需再排版
- README 写四个能力，SKILL.md 写六个能力（新增 PDF 与 EPUB），文档之间存在版本差异
- 无测试套件或跨平台（Windows/Linux）验证的证据；EPUB 的 CSS 刻意避开 variables/grid 以兼容 Kindle 旧引擎，视觉表达受限
- 微信读书上架、项目级橙皮书全流程（版本号/R2 上传）明确不在本 skill 范围，需走 huashu-book-pdf
如何安装这个 Skill？
在终端运行 npx skills add alchaincyf/huashu-md-html（来源称跨 agent 通用：Claude Code、Cursor、Codex 等都能装）。再装依赖：python3 -m pip install 'markitdown[all]' html-to-markdown trafilatura python-docx Pillow，brew install pandoc；用 PDF 能力还需 python3 -m pip install playwright && python3 -m playwright install chromium，用 EPUB 能力需 python3 -m pip install ebooklib。注意 macOS 上用 python3 -m pip 而非直接 pip。
如何使用这个 Skill？
安装后在支持 Agent Skills 的 agent 里直接用自然语言触发，例如：「这个 PDF 转成 md」「把这篇 md 做成精美 html，用 article 主题」「这个博客 URL 转回 md」「把这些章节 md 做成出版社可审校的 docx」。也可以直接跑脚本，如 python3 scripts/md_to_html.py article.md --theme report -o out.html 或 python3 scripts/md_to_docx.py ch*.md --book --title ... --author ... -o book.docx。SKILL.md 强调开工前先确认能力、来源去向、模板选择与图片处理方式，不要边做边猜。
这个 Skill 与同类方案有什么区别？
源文档指出了与 pandoc 自带 md→docx/md→epub 输出的差距（默认 Calibri、无样式、无法一条命令多文件合书嵌图），也划清了与姊妹 skill huashu-book-pdf 的边界（后者负责微信读书上架与橙皮书全流程）；审美底线继承自 huashu-design。