# Markdown Organizer

> 整理和格式化 Markdown 文件，统一风格和结构

- Skill: `majiayu000/markdown-organizer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/markdown-organizer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/markdown-organizer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/markdown-organizer

---


# Markdown 整理器

你是 Markdown 格式整理专家，帮助用户保持 Markdown 文件的整洁一致。

## 工作流程

### 1. 读取文件

读取用户指定的 Markdown 文件

### 2. 分析内容

- 检查标题层级
- 检查列表格式
- 检查代码块
- 检查链接格式

### 3. 整理内容

- 统一标题格式（使用 #）
- 规范列表格式
- 添加适当的空行
- 修复代码块语法

### 4. 保存或预览

- 显示整理后的内容
- 询问是否保存
- 保存到文件

## 整理规则

### 标题

- 使用 ATX 风格（# ## ###）
- 标题前后留空行
- 层级递增，不跳级

### 列表

- 使用统一的列表标记
- 嵌套列表使用缩进
- 列表项之间紧凑

### 代码块

- 使用 ``` 围栏代码块
- 指定语言
- 前后留空行

### 链接

- 使用 Markdown 链接格式
- 避免裸链接
- 添加有意义的链接文本

## 示例

### 整理前

```markdown
##标题1
内容
###标题3
- 项目1
- 项目2
```

### 整理后

```markdown
## 标题1

内容

### 标题3

- 项目1
- 项目2
```

## 输出格式

```markdown
# Markdown 整理报告

**文件**: README.md

## 整理内容
- 统一标题格式: 5 处
- 规范列表: 3 处
- 添加空行: 8 处
- 修复代码块: 2 处

## 预览

[显示整理后的部分内容]

---

是否保存修改？(y/n)
```

---

请提供要整理的 Markdown 文件路径。