# everything-markdown

**Repository Path**: himinn/everything-markdown

## Basic Information

- **Project Name**: everything-markdown
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-04
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Everything Markdown

**万物皆可 Markdown。**

一个 Claude Code Skill 集合，将任意内容转为干净的 Markdown 格式。

---

## 为什么需要这个？

你是否遇到过这些场景：
- 收到一个 PDF 报告，想提取内容用于整理笔记或写作素材？
- Excel 表格数据想转为 Markdown 表格，方便在文档中展示？
- 公众号文章想保存为纯文本，去除广告和干扰？

**Everything Markdown** 让你一句话完成这些任务。

---

## 快速开始

### 方式一：Claude Code Skill

```bash
# 将 skills 目录复制到 Claude Code 配置目录
cp -r skills/* ~/.claude/skills/

# 然后在 Claude Code 中直接说：
"把这个 PDF 转成 Markdown"
"解析这个 Excel 文件"
```

### 方式二：直接使用命令行

```bash
# 使用 uv（无需预先安装）
uvx --from 'markitdown[pdf,xlsx,pptx]' markitdown 文件路径 -o 输出.md
```

---

## Skills 目录

### 📄 markitdown

基于微软开源工具 [markitdown](https://github.com/microsoft/markitdown)（MIT 许可证，101K+ ⭐），本地文件转 Markdown。

| 输入 | 输出 |
|-----|------|
| PDF 报告 | 结构化 Markdown，保留表格和图片描述 |
| Word 文档 | 干净的 Markdown，去除格式噪音 |
| Excel 表格 | Markdown 表格，多 Sheet 自动分章节 |
| PPT 幻灯片 | 文本内容 + 图片描述 |
| 图片 | AI 生成的文字描述 |
| 音频 | Whisper 转录文本 |

**示例：**

```bash
# Excel 多 Sheet 转 Markdown
uvx --from 'markitdown[xlsx]' markitdown report.xlsx

# 输出：
## Sheet1
| 姓名 | 年龄 | 部门 |
|------|------|------|
| 张三 | 28   | 研发  |

## Sheet2
| 季度 | 销售额 |
|------|--------|
| Q1   | 150000 |
```

---

## 工具分工

不同来源的内容，用不同的工具：

| 输入类型 | 工具 | 原因 |
|---------|------|------|
| 本地文件 | `/markitdown` | 直接转换，保留结构 |
| 公众号/博客 URL | `/defuddle` | 去除广告、导航、推荐阅读 |
| 需要登录的网页 | `/web-access` + `/defuddle` | 先获取 Cookie 再提取 |
| Youtube 视频 | `/markitdown` | 自动生成转录 |

**公众号文章示例：**

```
用户：把这篇公众号文章转为 Markdown https://mp.weixin.qq.com/...
Claude：[调用 /defuddle] 已提取正文内容...
```

---

## 依赖要求

- **Python 3.10+** 或使用 `uvx`（自动管理 Python 版本）
- Claude Code（用于 Skill 方式）

---

## 许可证

本仓库 Skills 均基于开源工具封装：

| 工具 | 许可证 | 来源 |
|-----|--------|------|
| markitdown | MIT | Microsoft |
| defuddle | MIT | Anthropic |

---

## 致谢

- Microsoft markitdown 团队
- Anthropic defuddle 团队

---

**一句话，万物皆 Markdown。**