知识库 Markdown 排版｜郭亿易

它解决什么问题

知识库里的 Markdown 文档很少出自单一作者。多人协作、历史迁移、从不同编辑器导出，都会让同一批文档的排版风格互相打架：

• 标题层级混乱，# 之后直接跳到 ######，目录结构难以提取；
• 列表符号不统一，有的行用 -，有的用 *，嵌套缩进对不齐；
• 代码围栏未闭合或缺少语言标记，渲染出来是一整片灰底；
• 表格管道符数量不一致，部分渲染器直接报错；
• 空行过多或缺失，段落粘连与碎片化并存。

这类问题不影响内容本身，却直接拉低文档的可读性与专业感，逐篇手工修复又十分枯燥。

它如何工作

@user_8d36cde0/guoyiyi-v053-lark-markdown 把「排版」拆成一套可重复执行的格式检查与规范化流程，对给定的 Markdown 文档做统一处理：

• 标题规范化：重新梳理 # 至 ###### 的层级关系，保证章节结构连续、可被目录生成器识别；
• 列表统一：合并同一层级的列表符号与缩进宽度，修正嵌套错位；
• 代码块补全：检查围栏是否闭合，按需补上 python、bash 这类语言标记；
• 表格修正：补齐管道符，统一列数与对齐方式；
• 空白清理：合并多余空行，同时保留代码块内部的原始排版。

处理结果保持正文内容不变，只调整呈现层面的语法细节。

适用边界与注意点

• 该技能只做排版规范化，不改写正文，也不做翻译或润色；
• 含嵌入 HTML、复杂自定义块的文档可能需要人工复核；
• 超长文档建议分段提交，便于控制单次处理的范围；
• 具体行为以技能自身的 prompt 定义为准，建议先用一两篇文档试跑，确认效果后再批量使用。