zach22-1999/generic-skills / skills/zach-md-html
zach-md-html
Verified已降级的 Markdown→HTML 兼容转换器。仅当用户明确要求“使用 zach-md-html”、或明确说“不要重组内容,只把现成 Markdown 机械转换成 HTML/套用旧主题”时使用。不要因为用户只说“输出成 HTML”“生成 HTML 报告”“把日常报告做成 HTML”“数据报告/交付报告”而触发;这些任务应由模型从原始资料直接组织并生成自包含 HTML。此 Skill 不负责数据可视化、工作面、自由设计、万物转 md、html 转 md 或 md 转 docx。
examples/input/md-vs-html.md
View on GitHub# Markdown 与 HTML 的文档流水线
很多团队会把写作、评审、发布混在一个格式里:有人在 Word 里写,有人在网页编辑器里改,有人最后再把内容复制到别的平台。格式一多,版本就乱,AI 也很难稳定接手。
`zach-md-html` 的做法是把角色分开:
- `markdown` 负责生产:轻、可 diff、适合 AI 读写
- `HTML` 负责阅读和展示:可排版、可交互、浏览器直接打开
- `DOCX` 负责审校和交付:适合编辑、客户、投稿系统
## 为什么先写 Markdown
Markdown 的优势不是好看,而是稳定。
| 维度 | Markdown | HTML | DOCX |
|---|---|---|---|
| AI 读取 | 很轻 | token 成本高 | 需要解析 |
| 版本管理 | 适合 diff | 标签噪声多 | 不适合纯文本 diff |
| 最终展示 | 需要转换 | 浏览器直接打开 | Office 生态友好 |
所以更稳的流程是:先用 Markdown 写清楚,再按交付场景生成 HTML 或 DOCX。
## 一个实用工作流
1. 收到 PDF / DOCX / 网页资料,先转成 Markdown。
2. 在 Markdown 里做修改、补充、审校。
3. 对外展示时转成 HTML。
4. 需要编辑审校或投稿时转成 DOCX。
这个流程的好处是:所有中间修改都留在同一个源文件里,产物可以重复生成。
## 什么时候用工作面 HTML
不是所有内容都适合线性文章。下面这些场景更适合做成工作面:
- 三个方案横向对比
- 项目计划和里程碑
- 事故复盘时间线
- PR / 文档评审批注
- 周报和状态看板
这类内容如果只做成长文,读者需要来回跳转;做成 HTML 工作面后,可以在一个页面里比较、展开、复制和定位。
## 结论
把 Markdown 当源,把 HTML / DOCX 当产物,文档工作会更像软件工程:源文件稳定、产物可再生、AI 也更容易协作。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |