Skip to content

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。

# zach-md-html

> **状态:Deprecated / 兼容备用**
> 自 2026-07-15 起,它不再是日常报告、数据报告或正式交付的默认 HTML 入口。

## 当前定位

这个目录只保留“把一份已经写好的 Markdown 机械转换成 HTML”的兼容能力。它适合不需要重组内容、不需要数据可视化、只想快速改善基础阅读体验的场景。

日常报告应由模型从原始资料直接组织并生成 HTML,因为真正需要解决的是信息层级、数据表达和交付完整度,而不是给 Markdown 套一层 CSS。

## 明确调用

只有在你确定要保留 Markdown 原结构时,才显式调用:

```text
请使用 zach-md-html,不要重组内容,把这份现成 Markdown 机械转换成 report 主题 HTML。
```

或手动运行:

```bash
python3 scripts/md_to_html.py input.md --theme report -o output.html
```

可用旧主题:`article`、`report`、`reading`、`interactive`、`wechat`。

## 不再承担

- “输出成 HTML”这类普通报告请求
- 日报、周报、分析报告、调研报告和正式交付
- 数据卡、图表、趋势、比较和证据链表达
- workspace / dashboard / free-design
- 万物转 Markdown、HTML 转 Markdown、Markdown 转 DOCX

目录中的其他脚本、references 和示例暂时保留,只为避免破坏旧调用;它们不再属于本 Skill 的有效能力声明。

## 迁移方向

- 报告:模型从原始资料直接生成自包含 HTML
- 设计型网页:使用专门的网页或前端设计 Skill
- PDF、DOCX、表格等格式处理:使用对应的专业 Skill
- 已有 Markdown 的无脑转换:继续使用本目录中的 `md_to_html.py`

这次退役保留了脚本,没有删除历史产物。

## 推荐安装方式:让 AI 帮你装

> 本 skill 已降级为兼容备用,不建议新安装。确有需要时再装。

推荐在以下 IDE 中直接用自然语言安装:

- Claude Code
- Codex
- Cursor
- Kiro
- Antigravity

把下面这句话直接发给你的 AI:

```text
帮我安装 `zach-md-html` 这个 skill,来源仓库是 `generic-skills`。直接装到当前工作区,并检查 pandoc 和 Python 依赖。
```

## 如果安装或运行出错,直接让 AI 帮你排查

把下面这段直接发给你的 AI,并把报错信息、截图或终端输出一起贴上:

```text
我已经安装了 `zach-md-html`,但现在遇到了问题。请你直接帮我排查并尽量修复:

1. 先判断是 skill 文件缺失、依赖缺失、MCP 未连接、路径错误,还是当前 IDE 没有正确加载
2. 自动检查当前工作区里和 `zach-md-html` 相关的文件、配置和依赖
3. 如果可以自动修复,就直接修复
4. 修复后告诉我还需要重启 IDE、重新加载工作区,还是重新运行哪个命令
5. 最后给我一个最短的验证步骤,确认这个 skill 已经能用了
```

## 关于作者

关注「**Zach的进化笔记**」,获取 AI x 跨境电商的实战经验、工具和方法论
也会分享对应跨境电商和AI相关的一些思考:

<img src="../../assets/traffic/wechat-official-account.jpg" width="200" alt="公众号二维码" />

扫码加入交流群,一起交流 AI + 跨境电商的实战玩法:

<img src="../../assets/traffic/wechat-group.jpeg" width="200" alt="交流群二维码" />
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall