doc-convert

doc-convert is a skill for Claude Code, Codex from ZJU-REAL/Easel. It costs 77 tokens per session (594 once invoked), scanned A, original, Apache-2.0.

A converter that formats Markdown documents as HTML, printable PDF files, or long PNG images. Markdown is plain text with simple formatting marks for headings, lists, tables, and code.

In plain words
What is it for?
Use it to turn an article or other Markdown file into an HTML page, an A4 PDF, or a long image with a chosen width.
Why use it?
It provides consistent rendered versions for reading, printing, sharing, or platforms that cannot display Markdown. It only handles Markdown and does not convert DOCX or presentation files.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is python skills/shared/scripts/doc_convert.py convert -i article.md -o outputs/主题名/a.html.

Good fit Use it to turn an article or other Markdown file into an HTML page, an A4 PDF, or a long image with a chosen width.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/ZJU-REAL/Easel
agentmods
npx agentmods add skills/zju-real/easel/doc-convert

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for doc-convert

README.md
[![agentmods](https://agentmods.dev/badge/skills/zju-real/easel/doc-convert.svg)](https://agentmods.dev/skills/zju-real/easel/doc-convert)
Your own site
<a href="https://agentmods.dev/skills/zju-real/easel/doc-convert"><img src="https://agentmods.dev/badge/skills/zju-real/easel/doc-convert.svg" alt="Measured on agentmods" height="20"></a>
Per session 77 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 594 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00077 $0.00594
Opus 5 $0.00039 $0.00297
Sonnet 5 $0.00015 $0.00119
Haiku 4.5 $0.00008 $0.00059

Measured 8d ago against content hash 39aa44770c79, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

doc-convert scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/openclaw/doc-convert/SKILL.md · 50 lines

What it actually 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.pyconvert -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)。

规则

  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 无头 page.pdf()/screenshot(full_page) 出 PDF/长图,替代 pandoc 完成最常用的 MD 排版分发需求。

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 50 lines · 77 tokens per session scan A 39aa44770c79

Subscribe to this mod's changes

doc-convert is a skill published in the GitHub repository ZJU-REAL/Easel (411 stars, last pushed today), licensed Apache-2.0. It adds 77 tokens to every session and 594 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

pdf

A set of instructions for working with PDF files, which are documents designed to preserve their layout across devices.

agentscope-ai/QwenPaw · 95 tokens

nano-pdf

Edits PDF files using natural-language instructions via the nano-pdf CLI. Supports modifying text, changing titles, fixing typos, and updating content on specific pages. Use when the user wants to edit a PDF, modify PDF content, update PDF text, fix a typo in a PDF, change a PDF title, or rewrite part of a PDF page.

elizaOS/eliza · 75 tokens

pdf-toolkit

Structured .pdf operations: extract text/tables, merge pages from multiple PDFs, split a PDF by page ranges, fill PDF form fields, and generate fresh PDFs from JSON. Trigger when the user wants programmatic PDF work without natural-language rewriting — examples: pull tables from a report, combine three PDFs, extract…

opensquilla/opensquilla · 127 tokens

pdf-analysis

A PDF analysis method for reading both normal PDFs with selectable text and scanned PDFs made from page images.

OpenSenseNova/SenseNova-Skills · 48 tokens

nano-pdf

Edit PDFs with natural-language instructions using the nano-pdf CLI.

opensquilla/opensquilla · 17 tokens

meta-research-to-slide-deck

Use this meta-skill instead of answering directly when the user needs a researched presentation, leadership briefing, competitive analysis deck, or source-backed slide outline that benefits from multi-skill orchestration across search, source curation, synthesis, slides, and document export.

opensquilla/opensquilla · 60 tokens