「md 是源代码，html / docx 是产物。」
md/html/docx 多向流水线 · 四个能力一站式：万物 → md · md → 精美 html · html → md · md → 出版社级 docx
把任意文件（PDF / DOCX / PPTX / XLSX / EPUB / 图片 / 音频 / YouTube / 网页 URL）转成干净的 markdown，再用 4 套精挑过的主题加工成出色的 html，或反过来把已发布的 html 拉回来归档成 md。需要给出版社/编辑/投稿系统时——一条命令把 md 加工成出版社级 docx，自动嵌图、加封面、做目录、配页眉页脚。
每个能力都封装成一个命令，每套主题都过了反 AI slop 检查清单——没有紫渐变、没有 emoji 当图标、没有 #0D1117 深蓝底，配色克制，有出版社品位。
npx skills add alchaincyf/huashu-md-html
跨 agent 通用——Claude Code、Cursor、Codex、OpenClaw、Hermes 都能装。
看效果 · 装上就能用 · 四个能力 · 4 套 html 主题 · 一条龙工作流
▲ 20 秒 · Kenya Hara 极简风格 · md → 入·排·出 → html · 衬线 + 留白 + 一抹赤陶橙
👉 下载 MP4（含 BGM · 850KB）
另一版风格预览（点开看 Pentagram 信息建筑派 · 18 秒）
▲ Pentagram 信息建筑派 · 象牙白 + 墨黑 + 辛辣红 · 大字号 sans + 12 列网格 + tabular nums
👉 下载 MP4（含 BGM · 2MB）
📌 以上两段动画都是用 huashu-design skill 做的——作为本 skill 的宣传短片。 同一个产品，两种视觉哲学，差异不来自模板而来自设计语言。
npx skills add alchaincyf/huashu-md-html然后在 Claude Code 里直接说话：
「这个 PDF 转成 md」
「把这篇 md 做成精美 html，用 article 主题」
「这个博客 URL 转回 md，去掉导航和侧栏」
「把这份 PPTX 转成 md，再用 reading 主题做成发布版」
「把这些章节 md 做成一份出版社可审校的 docx」
「这份稿子做成投稿用的 word，A4 规格」
没有按钮、没有面板、没有 GUI。
| 用户说什么 | 能力 | 底层工具 | 入口脚本 |
|---|---|---|---|
| 「PDF / DOCX / PPTX / XLSX / EPUB / 图片 / 音频 / YouTube / 网页 URL → md」 | 能力 1：万物 → md | microsoft/markitdown | scripts/any_to_md.py |
| 「md → 精美 html / 文章 / 报告 / 阅读模式」 | 能力 2：md → 精美 html | pandoc + 4 套自调主题 | scripts/md_to_html.py |
| 「本地 html 或 URL → md / 归档已发布的博客」 | 能力 3：html → md | html-to-markdown + trafilatura | scripts/html_to_md.py |
| 「md → 出版社审校 docx / 投稿稿件 / 纸质书定稿」 | 能力 4：md → 精美 docx | python-docx + 出版社级排版预设 | scripts/md_to_docx.py |
决策原则：
- 能力 1 产出的 md 可以直接喂给能力 2，组成「PDF → 精美阅读 html」一条龙
- 能力 3 用于反向归档（把已发布的 html 拉回项目源）
- 能力 4 是出版终点——给人类编辑/出版社审校时用 docx，不要直接给 html 或 md，专业出版生态默认 docx
URL 既能走能力 1（markitdown）也能走能力 3（trafilatura），但产出质量差异巨大：
| 页面类型 | 走哪个 | 原因 |
|---|---|---|
| 结构化页面（产品详情、技术文档、API doc、证书页、电商商品页） | 能力 1（markitdown） | 保留 metadata、字段值、链接、标题层级 |
| 正文类页面（博客、新闻、Essay、长文） | 能力 3（trafilatura） | 自动去导航/侧栏/相关推荐/广告，只留正文 |
| 不确定 | 两个都跑一遍对比 | 看哪个对下游用途更合适 |
判断捷径：URL 里的内容是「读」的还是「查」的？读 → 能力 3（去噪），查 → 能力 1（保信息）。
每套都过了反 AI slop 检查清单。自包含单 CSS，HTML 打开即用，不依赖外部 CDN。
| 主题 | 哲学锚点 | 适合场景 |
|---|---|---|
| article | Tufte CSS 启发 · Pentagram 式信息建筑 | essay、博客、深度阅读、独立文章 |
| report | 出版社白皮书风 · 多表格密度型 | 技术报告、调研、白皮书、产品文档 |
| reading | Medium 风极简 · 单栏窄体大字 | 公众号转接、纯阅读、轻量分发 |
| interactive | 长文档导航型 · 折叠 + 目录 + 边栏 | 橙皮书章节、技术书籍、长教程 |
 article · Tufte 风 · 衬线 + 边距笔记 |
 report · 白皮书风 · 宽体多表格 |
 reading · Medium 风 · 单栏极简 |
 interactive · 长文档 · 侧边栏 + 折叠目录 |
正文字体（中文） PingFang SC, Source Han Serif, Noto Serif CJK
正文字体（英文） Inter, IBM Plex Sans, et-book
代码字体 JetBrains Mono, Fira Code
行高（中文） 1.75 - 1.85
行高（英文） 1.6
字号（桌面） 17 - 18px
最大宽度（文章） 680 - 720px
最大宽度（报告） 760 - 820px
代码块底色 #F6F8FA（浅模式）/ #1F2428（深模式）
引用块 左 4px 色条 + 浅灰底
禁用清单：紫渐变、赛博霓虹、#0D1117 深蓝底、Comic Sans、emoji 作正式图标。
为什么单独做能力 4？因为 pandoc md -o docx 出来的 docx 默认 Calibri、无表格样式、无封面、章节首页平淡——能给 AI 看，不能给出版社编辑改稿。
能力 4 的脚本内置了出版社版式预设：
# 单文件转换
python3 scripts/md_to_docx.py article.md
# 整本书（自动加封面 + 目录 + 页眉 + 章节分页）
python3 scripts/md_to_docx.py ch*.md postscript.md appendix.md --book \
--title "图解 Agent Skills" \
--subtitle "让 AI 记住你的工作方式" \
--author "花叔" \
--images-dir ./images \
-o book.docx版式特性：
| 元素 | 预设 |
|---|---|
| 页面 | 大 32 开（176×240mm）或 A4 |
| 章标题 | 章号小标 + 24pt 大字号 + 橙色底分隔线 + 英文副标题 |
| 引用块 | 按 emoji 自动配色：💡 琥珀 / ✅ 青色 / |
| 代码块 | 浅灰底 + 橙色左侧色边 + JetBrains Mono |
| 表格 | 表头底色 + 灰色边框 + 居中对齐 |
| 配图 | 居中嵌入 + 灰色斜体图说 |
| 页眉页脚 | 书名右对齐 + 居中自动页码 |
实战验证：用这个脚本生成《图解 Agent Skills》158 页出版社审校稿（9 章 + 后记 + 附录 + 57 张配图），一条命令搞定。
完整 cookbook 见 references/md-to-docx-cookbook.md。
依赖：python3 -m pip install python-docx Pillow
# 场景 1：PDF 白皮书 → 精美阅读 html
python3 scripts/any_to_md.py whitepaper.pdf -o whitepaper.md
python3 scripts/md_to_html.py whitepaper.md --theme report -o whitepaper.html
# 场景 2：YouTube 视频 → 文章博客
python3 scripts/any_to_md.py "https://youtube.com/watch?v=xxx" -o video.md
# 编辑 video.md...
python3 scripts/md_to_html.py video.md --theme article -o blog.html
# 场景 3：归档已发布的博客文章 → 项目源 md
python3 scripts/html_to_md.py "https://example.com/blog/article" -o article.md
# 场景 4：抓产品页 / 技术文档 → 完整结构化 md
python3 scripts/any_to_md.py "https://learn.microsoft.com/en-us/some-doc" -o doc.md
# 场景 5：橙皮书章节 → 多主题对比
python3 scripts/md_to_html.py chapter.md --theme article -o ch-article.html
python3 scripts/md_to_html.py chapter.md --theme interactive -o ch-interactive.html
# 场景 6：URL 不确定走哪条路 → 两个都跑对比
python3 scripts/any_to_md.py "https://example.com/page" -o page-markitdown.md
python3 scripts/html_to_md.py "https://example.com/page" -o page-trafilatura.md
# 场景 7：整本书 md → 出版社审校 docx
python3 scripts/md_to_docx.py md-v2/ch*.md md-v2/postscript.md md-v2/appendix.md --book \
--title "图解 Agent Skills" --author "花叔" --subtitle "让 AI 记住你的工作方式" \
--images-dir ./images-v2 -o 出版社审校版.docx
# 场景 8：PDF 论文 → docx 投稿（能力 1 → 能力 4）
python3 scripts/any_to_md.py paper.pdf -o paper.md
# 编辑 paper.md 修正格式...
python3 scripts/md_to_docx.py paper.md --page-size a4 -o paper.docx| 工具 | 用途 | 安装 |
|---|---|---|
markitdown |
万物 → md | python3 -m pip install 'markitdown[all]' |
pandoc |
md → html | brew install pandoc（macOS）/ 官网下载 |
html-to-markdown |
html → md（高速 Rust 引擎） | python3 -m pip install html-to-markdown |
trafilatura |
URL 正文提取 | python3 -m pip install trafilatura |
python-docx + Pillow |
md → 精美 docx | python3 -m pip install python-docx Pillow |
脚本启动时会自检，缺失的依赖会明确提示安装命令，不会静默失败。
⚠️ macOS Python 环境陷阱：pip和python3可能指向不同的 Python 版本（实测踩过：pip是 3.11、python3是 3.14）。安装依赖请用python3 -m pip install ...，不要直接pip install。
huashu-md-html/
├── SKILL.md # Agent 主文档（中文）
├── README.md # 本文件
├── scripts/ # 四能力入口
│ ├── any_to_md.py # 能力 1：万物 → md
│ ├── md_to_html.py # 能力 2：md → 精美 html
│ ├── html_to_md.py # 能力 3：html → md
│ └── md_to_docx.py # 能力 4：md → 出版社级 docx
├── templates/ # 4 套精挑 html 主题 + 公众号专用
│ ├── article/ # Tufte 风
│ ├── report/ # 白皮书风
│ ├── reading/ # Medium 极简
│ ├── interactive/ # 长文档导航
│ └── wechat/ # 公众号转接
├── references/ # 按任务深入文档（中文）
│ ├── markitdown-cookbook.md
│ ├── md-to-html-themes.md
│ ├── html-to-md-cookbook.md
│ ├── md-to-docx-cookbook.md # ⭐ 新增：md → docx 完整指南
│ ├── design-tokens.md
│ └── anti-ai-slop.md
├── examples/ # 主题预览
│ ├── input/md-vs-html.md
│ └── output/{article,report,reading,interactive}.{html,png}
├── demos/ # README 引用的宣传动画
│ ├── v3-hara-hero.{gif,mp4} # Kenya Hara 极简
│ └── v1-pentagram.{gif,mp4} # Pentagram 信息建筑
└── requirements.txt
这个 skill 的存在源于一个简单观察：AI 时代，文档的「生产格式」和「消费格式」第一次解耦了。
写作发生在 markdown——可 diff、AI 友好、版本可控。 分发发生在 html——排版精致、可分享、可导航。 来回切换不应该有成本。
大多数「转 X 到 Y」工具优化的是「转换保真度」。这个 skill 优化的是写作者的循环：
- 一份 md 是源——所有创作和编辑都在 md 里
- 多套 html 是产物——按场景挑主题，渲染一份精美的 html
- 来回往返不丢结构——把已发布的博客拉回项目源，或者把别人的好内容归档成 md
继承自 huashu-design 的反 AI slop 审美底线——4 套主题各有一个克制的强调色和一个出版级的排印签名，看起来像出版社做的，不像 SaaS 落地页。
MIT License — 个人和商业使用均自由，无需授权。
如果这个 skill 对你有帮助，欢迎 star 仓库；如果你做了有意思的衍生作品（新主题、新格式支持），欢迎 PR。
花叔是 AI Native Coder、独立开发者、AI 自媒体博主。代表作：小猫补光灯（App Store 付费榜 Top 1）、《一本书玩转 DeepSeek》、nuwa-skill（GitHub 21k+ stars）、huashu-design。全平台累计粉丝 30 万+。
| 平台 | 账号 | 链接 |
|---|---|---|
| X / Twitter | @AlchainHust | https://x.com/AlchainHust |
| 公众号 | 花叔 | 微信搜索「花叔」 |
| B 站 | 花叔 | https://space.bilibili.com/14097567 |
| YouTube | 花叔 | https://www.youtube.com/@Alchain |
| 小红书 | 花叔 | https://www.xiaohongshu.com/user/profile/5abc6f17e8ac2b109179dfdf |
| 官网 | huasheng.ai | https://www.huasheng.ai/ |
| 开发者 Hub | bookai.top | https://bookai.top |
商业合作、内容定制、咨询，请发邮件到 alchaincyf@gmail.com 或私信任一社交平台。