Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
把 Markdown 文稿排版并转换为 HTML、可打印 PDF 或长图 PNG。当用户说“Markdown/MD 转 HTML/PDF/图片、文章导出长图、MD 排版/渲染”时使用。仅处理 Markdown；DOCX/PPT 不在范围内，层级大纲转脑图用 mindmap。
Install Doc Convert
$ npx skills add ZJU-REAL/Easel --skill doc-convert -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ZJU-REAL/Easel doc-convert --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openclaw/doc-convert .claude/skills/doc-convert && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "doc-convert" agent skill from https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/doc-convert into .claude/skills/doc-convert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doc-convert", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/doc-convertType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add ZJU-REAL/Easel --skill doc-convert -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ZJU-REAL/Easel doc-convert --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/openclaw/doc-convert .agents/skills/doc-convert && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "doc-convert" agent skill from https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/doc-convert into .agents/skills/doc-convert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doc-convert", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ZJU-REAL/Easel --skill doc-convert -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ZJU-REAL/Easel doc-convert --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/openclaw/doc-convert .cursor/skills/doc-convert && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "doc-convert" agent skill from https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/doc-convert into .cursor/skills/doc-convert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doc-convert", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/ZJU-REAL/Easel.git --path skills/openclaw/doc-convert--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add ZJU-REAL/Easel --skill doc-convert -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ZJU-REAL/Easel doc-convert --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/openclaw/doc-convert .gemini/skills/doc-convert && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "doc-convert" agent skill from https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/doc-convert into .gemini/skills/doc-convert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doc-convert", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install ZJU-REAL/Easel doc-convertInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add ZJU-REAL/Easel --skill doc-convert -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/openclaw/doc-convert .github/skills/doc-convert && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "doc-convert" agent skill from https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/doc-convert into .github/skills/doc-convert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doc-convert", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ZJU-REAL/Easel --skill doc-convert -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ZJU-REAL/Easel doc-convert --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/openclaw/doc-convert .opencode/skills/doc-convert && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "doc-convert" agent skill from https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/doc-convert into .opencode/skills/doc-convert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doc-convert", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
doc-convert- GitHub stars
- 3.4k
- Token cost
- ~357 tokens
- SKILL.md length
- 75 words
- Files
- 1
- Skills in repo
- 114
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
把 Markdown 文稿排版并转换为 HTML、可打印 PDF 或长图 PNG。当用户说“Markdown/MD 转 HTML/PDF/图片、文章导出长图、MD 排版/渲染”时使用。仅处理 Markdown；DOCX/PPT 不在范围内，层级大纲转脑图用 mindmap。
- Works in 4 steps: 长图宽度 --width 按平台调（朋友圈/小红书… → 图片用相对/绝对可访问路径，渲染时要能加载到。 → 需要 DOCX/PPT/富交互排版时本 SKILL 不覆盖（提示用 pandoc… → …
- Tasks that involve Word documents
- SKILL.md covers 输入 / 输出, 执行, 前置 and 规则, plus 1 more section
- Calls python, pip and playwright
What it does
Doc Convert is an agent skill from ZJU-REAL/Easel. 把 Markdown 文稿排版并转换为 HTML、可打印 PDF 或长图 PNG。当用户说“Markdown/MD 转 HTML/PDF/图片、文章导出长图、MD 排版/渲染”时使用。仅处理 Markdown；DOCX/PPT 不在范围内，层级大纲转脑图用 mindmap。
Its SKILL.md is about 360 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Documents & Office, covering Word documents, Markdown and PDF. It works with Microsoft Word. The repository describes itself as: An open-source AI agent for social media — discover trends, create content, publish everywhere, and learn what works across Xiaohongshu, Douyin, Zhihu, Bilibili, and more.🎨一个开源的… The licence is Apache-2.0.
When your agent uses it
- Tasks that involve Word documents
- Tasks that involve Markdown
- Tasks that involve PDF
Example prompts
- “Markdown/MD 转 HTML/PDF/图片、文章导出长图、MD 排版/渲染”
- “/doc-convert”
Requirements
- Python 3
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- 长图宽度 --width 按平台调（朋友圈/小红书 ~750-1080）；正文宽度 --page-width 控制 HTML/PDF 版心。
- 图片用相对/绝对可访问路径，渲染时要能加载到。
- 需要 DOCX/PPT/富交互排版时本 SKILL 不覆盖（提示用 pandoc 或对应平台工具）。
- 产物统一进 outputs/主题名/。
What it can do on your machine
Read from SKILL.md and the folder at commit 278f420. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
pythonpipplaywright
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Doc Convert loads about 357 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 75 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from ZJU-REAL/Easel at commit 278f420, republished under its Apache-2.0 licence (© ZJU-REAL). 75 words, ~357 tokens.
Download SKILL.mdSave it as
.claude/skills/doc-convert/SKILL.md (or your agent's skills folder).- name
- doc-convert
- description
- 把 Markdown 文稿排版并转换为 HTML、可打印 PDF 或长图 PNG。当用户说“Markdown/MD 转 HTML/PDF/图片、文章导出长图、MD 排版/渲染”时使用。仅处理 Markdown；DOCX/PPT 不在范围内，层级大纲转脑图用 mindmap。
- layer
- produce
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）。
# 转干净 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）。
规则
- 长图宽度
--width按平台调（朋友圈/小红书 ~750-1080）；正文宽度--page-width控制 HTML/PDF 版心。 - 图片用相对/绝对可访问路径，渲染时要能加载到。
- 需要 DOCX/PPT/富交互排版时本 SKILL 不覆盖（提示用 pandoc 或对应平台工具）。
- 产物统一进
outputs/主题名/。
参考来源
python-markdown（含 extra/tables/fenced_code/toc 扩展）做 MD→HTML，Chromium 无头
page.pdf()/screenshot(full_page) 出 PDF/长图，替代 pandoc 完成最常用的 MD 排版分发需求。
© ZJU-REAL, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/openclaw/doc-convert of ZJU-REAL/Easel.
Open the folder on GitHubat commit 278f420
Compare with similar skills
Doc Convert next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Doc Convert this skillZJU-REAL/Easel | 3.4k | — | ~357 | Automated safety check: Pass | Apache-2.0 | |
| MarkitdownImCa0/just-laws | 781 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Gzh Designisjiamu/gzh-design-skill | 4k | — | ~2.2k | Automated safety check: Pass | AGPL-3.0 | |
| Doc Cleanernotoriouslab/doc-cleaner | 309 | — | ~712 | Automated safety check: Pass | MIT | |
| MineruNebutra/MinerU-Skill | 123 | — | ~504 | Automated safety check: Pass | MIT | |
| Pandic OfficeTeam-Commonly/commonly | 1.4k | — | ~642 | Automated safety check: Pass | Apache-2.0 |
Similar skills
Gzh Design
isjiamu/gzh-design-skill
微信公众号文章排版引擎，将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取，自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入（非 Markdown…
Doc Cleaner
notoriouslab/doc-cleaner
Convert PDF, DOCX, XLSX, and text files to clean, structured Markdown.
Mineru
Nebutra/MinerU-Skill
An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents.
Pandic Office
Team-Commonly/commonly
Convert Markdown to PDF (or DOCX/EPUB/HTML) using the pandoc CLI.
Doc To Markdown
daymade/claude-code-skills
Converts DOCX/PDF/PPTX and saved HTML/HTM to high-quality Markdown with automatic post-processing.
More from ZJU-REAL/Easel
All 114 skills in this repoGzh Design
ZJU-REAL/Easel
微信公众号文章排版引擎：把 Markdown / Word(.docx) / PDF / 纯文本转成可直接粘贴进公众号编辑器的 HTML，自动章节编号、关键词标记、引言卡、目录、代码块、图片/GIF、作者签名；主题从 references/theme-index.md…
Skill Wechat Publisher
ZJU-REAL/Easel
微信公众号文章自动创作与发布工具。给定参考文章、文字或文档，自动搜索整理全网相关信息、生成图文并茂的公众号文章，并发布到微信公众号草稿箱。特别强调反 AI 检测写作。
Card Design
ZJU-REAL/Easel
社媒卡片视觉设计系统：提供配色、中文字体层级、满画幅布局、品类骨架和死空白/密度质检，避免模板化 PPT 与廉价 AI 感。
Ecom Details Image
ZJU-REAL/Easel
生成电商商品视觉方案：主图概念、场景图、详情页视觉方向和 AI 生图 Prompt. An agent skill from ZJU-REAL/Easel.
Infographic
ZJU-REAL/Easel
将数据或文字内容转化为可视化信息图，支持静态（AntV）和动画 GIF 两种模式。当用户需要制作信息图、数据可视化、流程图、对比图、动画图表、GIF 图表、思维导图、SWOT 分析图时调用。本地渲染信息图/GIF 动画；要单张静态图片 URL 用 chart-visualization，要 CSV/JSON→整页报告用 data-report
Novel Writer
ZJU-REAL/Easel
长篇小说/网文连载创作：从世界观、人设和三级大纲写到逐章正文，并用文件化状态维护伏笔、前情和跨章一致性. An agent skill from ZJU-REAL/Easel.
Related
Works with
Categories
Questions about Doc Convert
What does Doc Convert do?
把 Markdown 文稿排版并转换为 HTML、可打印 PDF 或长图 PNG。当用户说“Markdown/MD 转 HTML/PDF/图片、文章导出长图、MD 排版/渲染”时使用。仅处理 Markdown；DOCX/PPT 不在范围内，层级大纲转脑图用 mindmap。. Doc Convert is an agent skill from ZJU-REAL/Easel.
When should I use Doc Convert?
Doc Convert fits situations like: tasks that involve Word documents; tasks that involve Markdown; tasks that involve PDF.
How do I install Doc Convert in Claude Code?
Run `npx skills add ZJU-REAL/Easel --skill doc-convert -a claude-code`. Or copy the skill folder (skills/openclaw/doc-convert in ZJU-REAL/Easel) into .claude/skills/doc-convert in your project. Claude Code loads it when a task matches its description.
How do I install Doc Convert in Codex?
Run `npx skills add ZJU-REAL/Easel --skill doc-convert -a codex`. Or copy the skill folder (skills/openclaw/doc-convert in ZJU-REAL/Easel) into .agents/skills/doc-convert in your project. Codex loads it when a task matches its description.
Can I use Doc Convert in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZJU-REAL/Easel --skill doc-convert -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/doc-convert, .gemini/skills/doc-convert, .github/skills/doc-convert and .opencode/skills/doc-convert in your project.
What does Doc Convert need to run?
Going by SKILL.md and its folder, Doc Convert needs the command-line tools its instructions call (python, pip and playwright). Our summary lists: Python 3.
Does Doc Convert access the network?
SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Doc Convert safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Doc Convert use?
Doc Convert is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Doc Convert use?
About 357 tokens (SKILL.md is roughly 1.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Doc Convert?
Skills that share tags, products or a category with Doc Convert: Markitdown (ImCa0/just-laws, 781 stars), Gzh Design (isjiamu/gzh-design-skill, 4k stars), Doc Cleaner (notoriouslab/doc-cleaner, 309 stars) and Mineru (Nebutra/MinerU-Skill, 123 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Doc Convert?
ZJU-REAL (a GitHub organization) maintains it in ZJU-REAL/Easel, which has 3,376 GitHub stars. The repository holds 114 skills in this directory. The repository was last updated on October 9, 2026.
Source: ZJU-REAL/Easel on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.