别吵了！我给你们开源了一个skill，随意转换md和HTML 👇 https://t.co/yYQIcwAF3Z https://t.co/ASKXKsIjfh

alchaincyf/huashu-md-html

Source: https://github.com/alchaincyf/huashu-md-html

npx skills add alchaincyf/huashu-md-html

Demo

_{▲ 20 秒 · Kenya Hara 极简风格 · md → 入·排·出 → html · 衬线 + 留白 + 一抹赤陶橙
👉 下载 MP4（含 BGM · 850KB）}

📌 以上两段动画都是用 huashu-design skill 做的——作为本 skill 的宣传短片。 同一个产品，两种视觉哲学，差异不来自模板而来自设计语言。

装上就能用

npx skills add alchaincyf/huashu-md-html

然后在 Claude Code 里直接说话：

「这个 PDF 转成 md」
「把这篇 md 做成精美 html，用 article 主题」
「这个博客 URL 转回 md，去掉导航和侧栏」
「把这份 PPTX 转成 md，再用 reading 主题做成发布版」

没有按钮、没有面板、没有 GUI。

三个能力

决策原则：能力 1 产出的 md 可以直接喂给能力 2，组成「PDF → 精美阅读 html」一条龙。能力 3 用于反向归档。

URL 输入的两条路径

URL 既能走能力 1（markitdown）也能走能力 3（trafilatura），但产出质量差异巨大：

判断捷径：URL 里的内容是「读」的还是「查」的？读 → 能力 3（去噪），查 → 能力 1（保信息）。

4 套主题

每套都过了反 AI slop 检查清单。自包含单 CSS，HTML 打开即用，不依赖外部 CDN。

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 作正式图标。

一条龙工作流

# 场景 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

依赖

脚本启动时会自检，缺失的依赖会明确提示安装命令，不会静默失败。

⚠️ 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         # 万物 → md
│   ├── md_to_html.py        # md → 精美 html
│   └── html_to_md.py        # html → md
├── templates/               # 4 套精挑主题 + 公众号专用
│   ├── article/             # Tufte 风
│   ├── report/              # 白皮书风
│   ├── reading/             # Medium 极简
│   ├── interactive/         # 长文档导航
│   └── wechat/              # 公众号转接
├── references/              # 按任务深入文档（中文）
│   ├── markitdown-cookbook.md
│   ├── md-to-html-themes.md
│   ├── html-to-md-cookbook.md
│   ├── 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 落地页。

License

MIT License — 个人和商业使用均自由，无需授权。

如果这个 skill 对你有帮助，欢迎 star 仓库；如果你做了有意思的衍生作品（新主题、新格式支持），欢迎 PR。

联系花叔（Huasheng）

花叔是 AI Native Coder、独立开发者、AI 自媒体博主。代表作：小猫补光灯（App Store 付费榜 Top 1）、《一本书玩转 DeepSeek》、nuwa-skill（GitHub 12k+ stars）、huashu-design。全平台累计粉丝 30 万+。

商业合作、内容定制、咨询，请发邮件到 [email protected] 或私信任一社交平台。