\ud83e\udd9e Nm Leyline Markdown Formatting — 标准Markdown排版

Night Market 技能 — 移植自 claude-night-market/leyline。如需完整的 agents、hooks 和 commands 体验，请安装 Claude Code 插件。 # Markdown 格式化规范 ## 何时使用 - 编写或编辑任何 Markdown 文档 - 审查散文是否符合换行规范 - 通过插件（scribe、sanctum 等）生成 Markdown ## 何时不使用 - 编辑代码块、表格或 frontmatter（这些有各自的格式化规则） - 不会被提交的快速草稿笔记 这些规范适用于所有由插件生成或修改的 Markdown 文档。目标：生成在 Git diff 中清晰可审、在移动设备上易读的散文。 ## 速查 编写或编辑 Markdown 散文时： 1. 散文在 80 字符处换行，使用混合换行（优先在句子/子句边界而非任意词边界断行） 2. 每个标题前后各留一个空行 3. 仅使用 ATX 标题（# 标题，禁用 setext 下划线） 4. 每个列表前留一个空行 5. 当内联链接导致行超长时使用引用式链接 ## 需要换行的内容 以下类型在 80 字符处换行： - 段落（流动散文文本） - 引用块文本（> 后的内容） - 列表项描述（- 或 1. 后的文本） - 定义列表中的描述 ## 禁止换行的内容 永远不要对以下类型做换行或重排： - 表格：管道分隔的行保持单行 - 代码块：围栏（ ` ）或缩进内容 - 标题：以 # 开头的行 - Frontmatter：--- 或 +++ 之间的 YAML/TOML - HTML 块：原始 HTML 元素 - 链接定义：[id]: url 引用行 - 图片引用：单独成行的 !alt - 单行列表项：可单行容纳的短 bullet ## 换行算法（摘要） 对每个散文段落： 1. 若整句 ≤80 字符，保持单行 2. 若整句 >80 字符，在第 80 列前最近的句子边界（. ! ? ）处断行 3. 若无句子边界，在第 80 列前最近的子句边界（, ; : ）处断行 4. 若无子句边界，在第 80 列前连词（and but or ）前断行 5. 若以上皆无，在第 80 列前最后一个词边界处断行 6. 绝不在反引号区间、链接文本或 URL 内部断行 完整算法及示例见 modules/wrapping-rules.md。 ## 结构规则 ### 标题前后空行 ``markdown 错误： 一些文字。 ## 标题 更多文字。 正确： 一些文字。 ## 标题 更多文字。 ` 例外：文件首行可为标题，无需前置空行。 ### 仅使用 ATX 标题 `markdown 错误： 标题 ======= 错误： 子标题 ---------- 正确： # 标题 正确： ## 子标题 ` ### 列表前空行 `markdown 错误： 一些引导文字： - 项目一 - 项目二 正确： 一些引导文字： - 项目一 - 项目二 ` ### 长 URL 使用引用式链接 当内联链接使行超长时，使用引用式语法： `markdown 错误（行过长）： 详见 formatting guide。 正确： 详见 [formatting guide][fmt-guide]。 [fmt-guide]: https://google.github.io/styleguide/docguide/style.html ` 链接定义放在当前小节末尾或文档末尾。同一 URL 多次出现时，使用单一共享引用定义。 短内联链接且行 ≤80 字符可接受： `markdown 可接受： 详见 the guide。 ``