Agent Skills
返回列表
Markdown 排版美化

Markdown 排版美化

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_a3ed06bc/markdown-tidy 技能。

技能介绍

要解决什么

Markdown 文档在多人协作、从不同编辑器粘贴或长期迭代后，排版会逐渐失控：标题层级跳跃、列表标记混用（- 和 * 混着来）、代码块围栏断裂、表格缺少分隔行，甚至行内空格都不统一。这类问题不一定破坏内容，但渲染出来就是一团乱麻，读着像没格式化的纯文本。更麻烦的是，很多人第一反应是让 AI 顺手改写或润色，结果连原意都丢了。

核心工作方式

这个技能只动排版，不改文字。它把整个文档当结构对象来处理，按块逐段修复：标题统一 # 后加空格并保证前后空行、列表标记保持一致（有序列表重新编号 1. 2. 3.）、代码围栏配对并补全语言标签、表格补分隔行、引用块统一 > 前缀。处理前先记录源文件中已有的 emoji 集合，处理后再核对，确保 一个不多、一个不少。

严格边界

它不是改写或翻译工具。标点符号、换行、URL 全部原样保留，哪怕看着别扭也不"顺手修"。如果某个语法错误必须改文字才能修好，技能会保留原文并提醒你注意。默认输出到 -tidy.md 副本，原文件不动。建议修复前先备份，或直接让它生成副本。

使用场景

  • 从编辑器或多人贡献中粘贴后 Markdown 排版混乱，需要统一标题层级和列表格式，同时保留原始文字。
  • 提交 README 或技术文档前，发现代码块围栏、表格或引用符号出错，需要修复语法并输出校验结果。
  • 博客草稿因标题缩进、空行和列表标记不一致而渲染异常，需要整理排版但不改内容。
  • 外部贡献稿的 Markdown 有语法错误，需要修复格式，避免改写句子或添加装饰符号。

适合人员

  • 技术文档维护者，需要修复 README 或 API 文档排版，同时保留术语和代码示例不变。
  • 技术博主，需要整理博客草稿的标题、列表和引用格式，避免改动原文表达。
  • 多人协作项目的社区维护者，需要处理贡献稿中的 Markdown 语法问题。
  • 写作团队，需要把杂乱的 Markdown 草稿整理成结构一致的文档，不重写句子。