doc-convert SKILL.md skillA
doc-convert from zju-real/easel is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add zju-real/easel/doc-convert@git:20261012.0d53744Pins git:20261012.0d53744 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- zju-real/easel
- Path
skills/builtin/doc-convert/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261012.0d53744, committed Oct 12, 2026
- Size
- 2,131 bytes
- Repository stars
- 3,982
- License
- Apache-2.0
把 Markdown 文稿排版并转换为 HTML、可打印 PDF 或长图 PNG。当用户说“Markdown/MD 转 HTML/PDF/图片、文章导出长图、MD 排版/渲染”时使用。仅处理 Markdown;DOCX/PPT 不在范围内,层级大纲转脑图用 mindmap。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Markdown 格式转换 / 排版 > 把 Markdown 排版成 HTML / PDF / 长图 PNG。走 `skills/shared/scripts/doc_convert.py` > (python-markdown 排版 + Chromium 打印/截图)。 > 思维导图见 mindmap;公众号专属排版见 skill-wechat-publisher;卡片/海报见 card-*/poster-hero。 ## 输入 / 输出 - 输入:Markdown 文件(支持标题、列表、表格、代码块、引用、图片等)。 - 输出(`outputs/主题名/`):按后缀 `.html` / `.pdf` / `.png`(长图)。 ## 执行 脚本路径(相对项目根):`skills/shared/scripts/doc_convert.py`(`convert -h`)。 ```bash # 转干净 HTML(可读排版 + CJK 字体) python skills/shared/scripts/doc_convert.py convert -i article.md -o outputs/主题名/a.html # 转 PDF(A4 可打印,适合存档/发送) python skills/shared/scripts/doc_convert.py convert -i article.md -o outputs/主题名/a.pdf # 转长图 PNG(适合发不支持 MD 的平台/朋友圈存档) python skills/shared/scripts/doc_convert.py convert -i article.md -o outputs/主题名/a.png --width 800 ``` ## 前置 - MD→HTML:需 `pip install markdown`。 - MD→PDF/PNG:需 playwright + chromium(`playwright install chromium`)。 ## 规则 1. 长图宽度 `--width` 按平台调(朋友圈/小红书 ~750-1080);正文宽度 `--page-width` 控制 HTML/PDF 版心。 2. 图片用相对/绝对可访问路径,渲染时要能加载到。 3. 需要 DOCX/PPT/富交互排版时本 SKILL 不覆盖(提示用 pandoc 或对应平台工具)。 4. 产物统一进 `outputs/主题名/`。 ## 参考来源 python-markdown(含 extra/tables/fenced_code/toc 扩展)做 MD→HTML,Chromium 无头 …
Read the whole file at its exact version.
How to install
mdr add zju-real/easel/doc-convert@sha256:39aa44770c79e736The line at the top of this page pins the label git:20261012.0d53744, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_jyur5siqbligwhsg)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 12, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2131 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
zju-real/easel · 3,982 stars · license Apache-2.0 · pushed 2026-10-21 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_jyur5siqbligwhsg GET https://markdownregistry.com/api/v1/resolve?ref=zju-real/easel/doc-convert GET https://markdownregistry.com/api/v1/blob/39aa44770c79e736b0d5c297df9ee85e6b5509f87d04b7c110c1000177ddafef
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.