用途:在创建或编辑 Markdown 文件时提供统一的写作规范,确保格式、代码块与结构一致。
主要能力与规则:
- 代码块必须标注语言,如 bash、yaml、json、text、hcl、go 等,禁止使用裸 ```。
- 禁止使用表情符号、特殊字形或长破折号。
- 章节标题必须使用正确的标题层级,如 ##、###,不能用单独一行加粗代替。
- 每个文件只允许一个 H1,文件首行应为 # 标题。
- 遵循格式化器契约:PostToolUse 钩子会在每次写入后重新格式化 Markdown,具体改写内容与无法修复的 lint 规则见 /md-lint。
- 不同类型的 Markdown 元素之间加一个空行,不要留多个空行。
- 文件末尾保留单个换行符,可用 tail -c 1 file.md | xxd 检查,应输出 0a。
示例要点:标题与段落、列表、引用之间各留一个空行;标题用 ### 而非加粗;代码块需带语言标识如 ```bash。
限制:资料未说明具体安装命令、支持平台或收费方式,暂未提供;/md-lint 的规则细节仅在资料中被引用,未展开说明。