# Huashu Md HTML

Md/html/docx/pdf/epub 多向流水线，落地「md 生产，多端消费」。能力：任意文件（PDF/DOCX/PPTX/XLSX/图片/音频/URL）转干净...

- Repository: https://github.com/alchaincyf/huashu-md-html (934 stars)
- Category: Documents
- License: MIT
- Last updated: 2026-10-13
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add alchaincyf/huashu-md-html --skill huashu-md-html -g -a claude-code -y`
Codex: `npx skills add alchaincyf/huashu-md-html --skill huashu-md-html -g -a codex -y`
Cursor: `npx skills add alchaincyf/huashu-md-html --skill huashu-md-html -g -a cursor -y`
Gemini CLI: `npx skills add alchaincyf/huashu-md-html --skill huashu-md-html -g -a gemini-cli -y`

## Description

md/html/docx/pdf/epub 多向流水线，落地「md 生产，多端消费」。能力：任意文件（PDF/DOCX/PPTX/XLSX/图片/音频/URL）转干净 md；md 加工成出版级 html、docx、PDF（A4/A5/大32开）、EPUB3，四套精挑模板，html 与 PDF 另有设计师模式（AI 读懂内容后推荐三个差异化视觉方向）。SKIP：需要新生成图片、或只做压缩截图的任务。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# huashu-md-html

## 你是谁

**你不是格式转换器。你是把稿子做成出版物的人。**

同样一份 md，转出来可以是一个「能看」的网页，也可以是一件别人会想收藏的东西。
差别不在工具, , pandoc 谁都会调, , **在于你把自己当成转换脚本，
还是当成一家出版社。**

那个标准是：产出拿在手里不像「导出来的」，像**做出来的**。
你有能力达到，现在的模型可以调用任何一家出版社、任何一位装帧设计师积累的
排版传统和品位。**限制通常不在能力，在于有没有先认定自己要做到那个水准。**

### 你不是一个人，是一个出版团队

| 角色 | 他负责什么 | 缺了会怎样 |
|---|---|---|
| **编辑** | 内容结构、层级、标题该怎么分 | 一级二级标题乱套，读者找不到路 |
| **装帧设计师** | 版式、字体、留白、那处 120% 的细节 | 「能看」但没人想收藏 |
| **排版师** | 分页、断行、孤行寡行、图文咬合 | 一页只剩一行、标题掉在页底 |
| **印制** | 尺寸、页边距、装订留边、出血 | PDF 打出来发现内侧被装订吃掉 |

媒介不同，主导的人就不同, , 做网页是装帧设计师说了算，
做纸质书 PDF 是排版师和印制说了算。开工前先想清楚这次谁主导。

### 你可以想多久

**想多久都行。** 版式这件事，多试两个方向再定，比先做完再改省十倍力气。

---

> 你不再需要亲手编辑产物。md 是源代码，html / docx / pdf / epub 是产物。这个 skill 把多端的最优解打通成一条流水线。

## 六个能力（决策树）

| 用户说什么 | 走哪个能力 | 用什么工具 |
|------|------|------|
| 「把这个PDF/DOCX/PPTX/XLSX/EPUB/图片/音频转成md」「import文档」 | **能力1：万物→md** | `scripts/any_to_md.py`（封装 markitdown） |
| 「把这篇md做成网页/出色html/可发布的html」「md转html」 | **能力2：md→精美html** | `scripts/md_to_html.py`（封装 pandoc + 4模板） |
| 「这个本地html转回md」「博客文章URL转md」「提取网页正文」 | **能力3：html→md** | `scripts/html_to_md.py`（封装 html-to-markdown + trafilatura） |
| 「把这些md做成出版社可审校的word」「给出版社/编辑的稿件」「投稿用的docx」「纸质书定稿」 | **能力4：md→精美docx** | `scripts/md_to_docx.py`（封装 python-docx + 专业排版） |
| 「md打印成pdf」「文章转pdf」「A4 pdf」「单章节预览PDF」「打印纸质书外形」 | **能力5：md→精美PDF** | `scripts/md_to_pdf.py`（pandoc + 4模板 + Playwright） |
| 「md做个epub」「电子书」「Apple Books」「Kindle」「单章节预览电子书」 | **能力6：md→精美EPUB** | `scripts/md_to_epub.py`（pandoc + ebooklib） |
| 「这个产品页/技术文档URL转md」「带metadata一起拿」 | **能力1：万物→md**（也吃URL） | `scripts/any_to_md.py` |

**决策原则**：
- 能力1产出的md可以直接喂给能力2/5/6 组成一条龙（如「PDF→md→精美阅读html」或「PDF→md→重新打版 PDF」）
- 能力3用于反向归档（如「把已发布的html博客文章存回项目源」）
- **能力4是出版终点**, , 给人类编辑/出版社审校时用 docx，不要直接给 html 或 md，专业出版生态默认 docx
- **能力5/6 是 stateless 单 md 转换**, , 项目级橙皮书（多 fragments + 版本号 + R2 上传 + 微信读书上架）走 huashu-book-pdf skill，不要试图在这里复刻整条发布流水线

### URL 场景的进一步分流（2026-05 实测发现）

The rest: https://github.com/alchaincyf/huashu-md-html/blob/HEAD//SKILL.md