把纯文本或结构松散的 Markdown 整理成标题、摘要、层级、列表、引用和代码块清楚的可读文档。适合文章内容基本完成，但缺少稳定结构、统一格式或适合发布的 Markdown 排版。

技能说明

Markdown 排版整理助手

这个 Skill 能做什么

把纯文本或结构松散的 Markdown 整理成标题、摘要、层级、列表、引用和代码块清楚的可读文档。

完成任务时重点处理：

• 标题层级与段落节奏
• 列表、引用、代码和强调的语义使用
• 保留原意并输出干净文件

最终目标不是堆出一份看似完整的内容，而是交付能够直接使用、继续修改并清楚验收的结果。

什么时候使用

• 文章内容基本完成，但缺少稳定结构、统一格式或适合发布的 Markdown 排版。
• 用户需要把纯文本或结构松散的 Markdown 整理成标题、摘要、层级、列表、引用和代码块清楚的可读文档。
• 任务需要同时控制标题层级与段落节奏、列表、引用、代码和强调的语义使用。

如果文章逻辑尚未完成时先提供结构建议，不把内容重写伪装成单纯排版，先处理前置条件，不要直接假装任务已经完成。

开始前需要什么

优先收集：

1. 输入文件、文本或数据位置 2. 文档用途与目标读者 3. 模板、页面规格和格式要求 4. 必须保留、允许修改和需要核对的内容 5. 原始文本文件与期望发布位置 6. 是否需要 frontmatter、摘要、目录或特定语法

信息不必一次问完。先检查用户已经提供的材料，只追问会明显改变结果的问题。

执行步骤

1. 读取全文结构

识别主题、章节、并列关系、代码和引用。

2. 建立标题树

修正跳级、重复标题和过深层级。

3. 整理段落

拆分过长段落，合并碎片句，保留作者语气。

4. 应用语义格式

只在有意义时使用列表、粗体、引用和代码块。

5. 补齐文档信息

按需要添加标题、摘要、frontmatter 和目录。

6. 检查渲染

确认链接、代码围栏、表格和特殊字符正常显示。

输出格式

至少交付以下内容：

• **格式化文档**：保留原内容并完成结构整理的 Markdown
• **变更摘要**：新增结构、修复项目和未改内容
• **渲染检查**：链接、代码、表格与标题层级结果

所有文件使用能说明内容和版本的名称。若任务包含执行动作，还要记录执行状态、验证结果和可继续处理的材料。

完整示例

用户提供一篇由笔记拼成的教程；先按任务阶段重建标题，再把命令放入代码块、注意事项放入引用块。

合理处理顺序：

1. 读取全文结构 2. 建立标题树 3. 整理段落 4. 应用语义格式 5. 补齐文档信息 6. 检查渲染

交付时应重点展示格式化文档、变更摘要、渲染检查，并说明尚未验证的部分。

质量检查清单

• [ ] 输出文件能够正常打开和继续编辑
• [ ] 内容结构、编号和格式前后一致
• [ ] 关键数据、名称和引用已经复核
• [ ] 完成结构检查，并在可行时完成视觉预览
• [ ] 没有为了排版改变事实或删除关键内容
• [ ] 代码围栏、列表缩进和表格语法完整

信息不足时怎么处理

• 缺少模板时先给出结构草案，再采用通用专业格式。
• 环境不能完成某项文件操作时，先交付可执行方案并标出待处理步骤。
• 文章逻辑尚未完成时先提供结构建议，不把内容重写伪装成单纯排版。