我做了一个 Skill：ky-markdown-rebuilder

专门把 PDF、PPT、白皮书、方案书、课程资料、长截图这类“视觉文档”，重建成结构可靠的 Markdown，因为 AI 读这些源文件会比较差，Markdown 除了可以让 AI 更好地读文件，还能把这些源文件变成可利用可重新构建的资产

微软官方已经有 MarkItDown，但用过的都知道其实很不好用，它更适合做“格式转换”和“文字抽取”

普通 Word、网页、线性 PDF，用 MarkItDown 就够了。 一旦遇到 PPT、销售 deck、图表等等比较复杂的报告，问题会很多：

左右栏会混在一起、时间线会乱序、架构图会变成散字、表格、截图、注释容易挤成一团，AI 后面再读，就会把乱文本当真

ky-markdown-rebuilder 会先抽文本，再把原文件渲染成一页页截图，对照真实版面重新整理 Markdown

它可以做到：

1、按页还原 每一页单独成节，不把相邻页面揉在一起

2、按视觉关系整理 左右栏、卡片、流程图、时间线、对比矩阵、截图说明，会按原来的结构重建

3、适合复杂文档 PPT、PDF 报告、白皮书、课程资料、产品 deck、销售方案书、长截图都能处理

4、支持深度视觉模式 遇到信息密度高的页面，会专门检查布局、图表、模块关系，不只是抽几行文字

5、能继续生成大纲 如果需要 outline，会基于校准后的 Markdown 生成，而不是直接拿乱序文本总结

我用初中化学课本还有今天合作伙伴发的PPT，做出来放了一些效果示例图，看下面图片可以直观地看到效果

一份规整的 Markdown 文档，在使用过程中能够极高地提升效率

我把这个 Skill 放到 Github 了，需要的朋友可以试试！https://github.com/KyrieCheungYep/ky-markdown-rebuilder…

KyrieCheungYep/ky-markdown-rebuilder

Source: https://github.com/KyrieCheungYep/ky-markdown-rebuilder

KY Markdown Rebuilder

一个用于 Codex / Claude Code 的文档重建 Skill。

用途：把视觉结构复杂的 PDF、PPT、长截图、报告、方案 deck 等资料，重建成清晰、可靠、按页对齐的 Markdown。

可以尽量保留页面结构、表格、卡片、图示关系和视觉阅读顺序。

适合处理

• PPT / PPTX / slide deck
• PDF 报告、白皮书、课程资料
• 图文混排的方案文档
• 含表格、流程图、架构图、时间线、矩阵的资料
• 长截图或视觉密集页面

不适合简单纯文本文件。纯文本文件直接转换即可，不需要这个 Skill。

安装到 Codex

mkdir -p ~/.codex/skills
git clone https://github.com/KyrieCheungYep/ky-markdown-rebuilder.git ~/.codex/skills/ky-markdown-rebuilder

安装到 Claude Code

mkdir -p ~/.claude/skills
git clone https://github.com/KyrieCheungYep/ky-markdown-rebuilder.git ~/.claude/skills/ky-markdown-rebuilder

使用方式

在 Codex 或 Claude Code 中直接点名这个 Skill：

[$ky-markdown-rebuilder] 帮我把这个 PPTX 做成 Markdown

也可以自然语言触发：

把这个视觉比较复杂的 PDF 重建成按页对齐的 Markdown

默认输出

通常会生成：

source.calibrated.md

如果你要求大纲版、outline、两个文件，则会同时生成：

source.outline.md

输出特点

对于复杂文档，Markdown 会尽量按原页面重建：

• 每页或每张 slide 单独成节
• 保留页面标题和主要内容
• 表格尽量转成 Markdown 表格
• 卡片、分栏、流程、矩阵会按结构整理
• 对图片、截图、图表、架构关系做必要说明
• 避免把页面内容混成一大坨散乱文本

English

KY Markdown Rebuilder is a document reconstruction skill for Codex / Claude Code.

It converts visually complex PDFs, PPT decks, long screenshots, reports, and proposal documents into clean, reliable, page-aligned Markdown.

It is designed for documents where plain text extraction is not enough, especially when layout, tables, diagrams, cards, timelines, screenshots, or visual hierarchy matter.

Install for Codex

mkdir -p ~/.codex/skills
git clone https://github.com/KyrieCheungYep/ky-markdown-rebuilder.git ~/.codex/skills/ky-markdown-rebuilder

Install for Claude Code

mkdir -p ~/.claude/skills
git clone https://github.com/KyrieCheungYep/ky-markdown-rebuilder.git ~/.claude/skills/ky-markdown-rebuilder

Usage

[$ky-markdown-rebuilder] Convert this PPTX into Markdown

Typical output:

source.calibrated.md

If an outline is requested:

source.outline.md