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.

Install it, pinned
mdr add zju-real/easel/doc-convert@git:20261012.0d53744

Pins 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

The exact contents, by fingerprint
mdr add zju-real/easel/doc-convert@sha256:39aa44770c79e736

The 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jyur5siqbligwhsg.svg)](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.

versioncommittedcommitsizeaudit
git:20261012.0d53744 latest2026-10-12 0d53744 2,131 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • 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

GitHub

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.

More from zju-real/easel

AGENTS.md@agents/workspace AGENTS.md file
zju-real/easel · agents/workspace/AGENTS.md
git:20261012.0d53744 · audit B · 3,982 stars
ai-image-gen SKILL.md skill
zju-real/easel · skills/builtin/ai-image-gen/SKILL.md · 通用 AI 生图:文生图 / 图生图 / 图像变体。当用户说 AI 生图、AI 画图、文生图、图生图、生成图片、生成配图、图像生成、AI 出图、AI 作图、换图、改图、图像编辑、给我画一张、生成一张图 时使用。支持 OpenAI 兼容…
git:20261012.0d53744 · audit A · 3,982 stars
ai-music SKILL.md skill
zju-real/easel · skills/builtin/ai-music/SKILL.md · AI 音乐 / BGM 生成:给短视频、社媒内容生成原创背景音乐 / 配乐 / 纯音乐。通过可插拔 provider(阿里 DashScope / Suno 类第三方…
git:20261012.0d53744 · audit A · 3,982 stars
ai-video-gen SKILL.md skill
zju-real/easel · skills/builtin/ai-video-gen/SKILL.md · AI 视频生成:文生视频 / 图生视频 / 数字人首帧驱动。通过可插拔 provider(通义万相 Wan / 火山 Seedance / 快手可灵 / OpenAI 兼容)异步生成视频,用户自备 API key。当用户说 AI…
git:20261012.0d53744 · audit A · 3,982 stars
asset-manager SKILL.md skill
zju-real/easel · skills/builtin/asset-manager/SKILL.md · outputs/ 目录下的产物管理:按日期/平台/类型归档、打标签、搜索历史内容、生成素材清单。 当用户说"整理素材"、"归档"、"找之前的内容"、"搜索历史"、"素材管理"、 "outputs 整理"、"之前做的"时使用。 与其他…
git:20261012.0d53744 · audit A · 3,982 stars
audio-denoise SKILL.md skill
zju-real/easel · skills/builtin/audio-denoise/SKILL.md · 音频降噪:去除录音中的背景噪声、电流声、风噪、嗡嗡声,基于 ffmpeg 滤镜链(afftdn/highpass/lowpass)。 当用户说"降噪""去噪""去杂音""消除背景噪声""电流声""风噪""录音有杂音""音频降噪"时使用。…
git:20261012.0d53744 · audit A · 3,982 stars
audio-editing SKILL.md skill
zju-real/easel · skills/builtin/audio-editing/SKILL.md · 通用音频处理:音频剪辑/裁剪、格式转码(mp3/wav/m4a/aac)、音量归一化、从视频提取音轨、多段拼接、淡入淡出、变速(保音高)。当用户说“剪音频”“裁一段”“转成…
git:20261012.0d53744 · audit A · 3,982 stars
audio-mix SKILL.md skill
zju-real/easel · skills/builtin/audio-mix/SKILL.md · 音频混合 / 混音:把旁白口播 + 背景音乐 + 音效混成一轨,BGM 自动循环补足并可闪避(旁白说话时自动压低 BGM 保证人声清晰)。当用户说 混音、音频混合、旁白加背景音乐、配音加BGM、人声和音乐混一起、加音效、音频叠加、BGM…
git:20261012.0d53744 · audit A · 3,982 stars
audio-visualizer SKILL.md skill
zju-real/easel · skills/builtin/audio-visualizer/SKILL.md · 音频可视化视频:把纯音频(播客片段、音乐、口播金句、电台)渲染成带动态波形/频谱的视频,配封面和标题,好发到抖音/B站/视频号等只收视频的平台。当用户说…
git:20261012.0d53744 · audit A · 3,982 stars
auto-short-video SKILL.md skill
zju-real/easel · skills/builtin/auto-short-video/SKILL.md · 一句话主题 → 成品短视频:自动串联 文案→配图/AI视频→配音→字幕→BGM→合成,把 Easel 制作层零件编排成一条'一键出片'流水线。**单条视频、口播/资讯向,画面默认逐句配图 + Ken Burns…
git:20261012.0d53744 · audit A · 3,982 stars
auto-subtitle SKILL.md skill
zju-real/easel · skills/builtin/auto-subtitle/SKILL.md · 自动字幕 / 语音转字幕:把音频或视频里的语音识别成字幕文件(SRT/ASS/TXT/JSON),可选把字幕烧录进视频。当用户说自动字幕、语音转字幕、视频加字幕、上字幕、转录、听写、字幕文件、生成字幕、烧字幕时使用。
git:20261012.0d53744 · audit A · 3,982 stars
batch-process SKILL.md skill
zju-real/easel · skills/builtin/batch-process/SKILL.md · 批量处理:对一个目录里的一批图片/视频/音频统一套用同一操作——批量压缩、加水印、转格式、缩放、转比例、音量归一化等。当用户说 批量处理、批量压缩、批量加水印、批量转格式、一批图片/视频、给这个文件夹、全部转成、批量缩放、批量转竖版、整个目…
git:20261012.0d53744 · audit A · 3,982 stars

Every file in zju-real/easel

Other files named doc-convert

doc-convert SKILL.md skill
zwolf25/tokenminning · tools/doc-convert/SKILL.md · Convert documents locally, without spending model tokens — PDF/DOCX/PPTX/XLSX → Markdown, and Markdown → styled DOCX…
git:20260907.723b1fa · audit A · 33 stars

Browse by kind, by grade A, or by owner.