markdownlint 与 Prettier `--tab-width=4` 的列表缩进配置实战-北京尧图网络

开发工具代码质量Lint静态分析【免费下载链接】markdownlintA Node.js style checker and lint tool for Markdown/CommonMark files.项目地址https://gitcode.com/gh_mirrors/ma/markdownlint点击查看免费下载本指南围绕仓库 doc/Prettier.md 中记录的 Prettier 兼容性场景以测试夹具 test/prettier-tab-width-4.md 为实例讲解当 Prettier 以--tab-width4格式化 Markdown 时如何通过list-marker-spaceMD030与ul-indentMD007两个规则的配置让 markdownlint 与 Prettier 的输出完全兼容、零告警。阅读完你将掌握两种 tab-width 下列表格式的差异、对应规则的参数含义与默认值、内联配置文件markdownlint-configure-file的用法以及如何用仓库自带测试与快照验证配置的正确性。背景markdownlint 与 Prettier 的协作方式Prettier 是广受欢迎的代码格式化工具而 markdownlint 是面向 Markdown/CommonMark 文件的 lint 工具。两者在绝大多数场景下可以无缝协作markdownlint 负责检查风格问题Prettier 负责重排格式各司其职。仓库中的 doc/Prettier.md 给出了两种协作策略直接扩展官方预置样式在 markdownlint 配置中extend仓库自带的 style/prettier.json该样式会将所有与 Prettier 存在重叠的规则一次性禁用包括line-length、list-indent、list-marker-space、ul-indent、no-trailing-spaces等 22 条规则。适合格式化交给 Prettier、lint 只管 Prettier 不管的规则的团队。针对特定场景微调如果仍需保留列表相关规则做 lint则按本文介绍的参数组合进行配置。问题场景--tab-width4与默认缩进不一致Prettier 的 Markdown 列表默认按--tab-width2排版这与 markdownlint 的默认配置天然兼容不会产生任何 lint 告警对应测试夹具 test/prettier-tab-width-2-default.md其格式为- Item、两级嵌套缩进 2 空格。但当 Prettier 以--tab-width4运行时无序列表的排版变为- Item - Item - Item此时默认配置的 markdownlint 会立即报告两条规则违规MD030 / list-marker-space默认要求列表标记-、*、、1.后只有 1 个空格而 Prettier 在-后写了 3 个空格MD007 / ul-indent默认要求嵌套无序列表每层缩进 2 个空格而 Prettier 每层缩进 4 个空格。官方推荐的配置方案doc/Prettier.md给出的解决方案是以下 JSON 配置片段{ list-marker-space: { ul_multi: 3, ul_single: 3 }, ul-indent: { indent: 4 } }该配置以options.config传入lintAPI或写入任意 markdownlint 配置文件.markdownlint.json/.markdownlintrc等。它只调整了无序列表的规则有序列表无需改动——原因见下文对齐原理。参数逐项解析两个规则、四个开关MD030list-marker-space标记后的空格数规则文档见 doc/md030.md实现见 lib/md030.mjs。该规则检查列表标记与列表项文本之间的空格数量共 4 个参数默认值均为1参数含义默认值ul_single单行无序列表项标记后空格数1ul_multi多行无序列表项标记后空格数1ol_single单行有序列表项标记后空格数1ol_multi多行有序列表项标记后空格数1源码中单行 / 多行的判定逻辑为列表总行数等于列表项数量时视为单行allSingleLine否则视为多行包含子列表、代码块、多段落的情况。因此在--tab-width4的文档里顶部无嵌套的简单列表- Item属于单行列表需要ul_single: 3含嵌套子列表的列表跨越多个行属于多行列表需要ul_multi: 3。两个值都必须设置为3缺一不可。MD007ul-indent无序列表缩进规则文档见 doc/md007.md实现见 lib/md007.mjs。该规则检查无序列表项的缩进参数如下参数含义默认值indent每层嵌套的缩进空格数2start_indented首层列表是否也缩进布尔值falsestart_indent首层列表的缩进空格数仅start_indented开启时生效2--tab-width4场景只需将indent设为4。源码中预期缩进按expectedIndent baseIndent (startIndented ? startIndent : 0) (nesting * indent)计算即嵌套深度乘以indent参数同时该规则会输出fixInfo因此违规项可以被applyFixes自动修复。另外注意MD007 只在其父列表也全为无序列表时生效混入有序列表的层级不受影响。对齐原理为什么无序用 3 空格、有序不用改以--tab-width4排版时Prettier 让嵌套列表内容按 4 列对齐无序标记-占 1 列标记后补 3 个空格内容起始于第 4 列嵌套列表每层缩进 4 个空格子列表的标记与内容正好与父级内容列对齐- Item - 标记 1 列 3 空格 4 列 - Item - 缩进 4 列子标记对齐父内容有序标记如1.占 2 列标记后仅需 1 个空格即可让内容落在第 4 列因此ol_single/ol_multi保持默认值1即可。这正是配置中只调整ul_*与ul-indent的原因。实测夹具内联配置文件markdownlint-configure-file仓库以测试夹具形式固化了这个场景。文件 test/prettier-tab-width-4.md 完整复现了 Prettier--tab-width4的格式化输出并在文件末尾使用 markdownlint 的内联文件级配置语法详见 README.md 的 Configuration 一节!-- markdownlint-configure-file { list-marker-space: { ul_multi: 3, ul_single: 3 }, ul-indent: { indent: 4 } } --该注释的语义配置作用于整个文件与注释所在位置无关默认按 JSON 解析可通过options.configParsers扩展为 YAML/TOML 等格式。在源码 lib/markdownlint.mjs 的configureFile函数中解析结果会与既有配置做浅合并{ ...config, ...parsed }因此内联配置可与全局配置叠加使用。夹具正文覆盖了五种典型结构无嵌套的简单无序列表含两层嵌套的多项无序列表无嵌套的简单有序列表含两层嵌套的多项有序列表无序、有序两种结构的混合。测试验证快照确认真零告警每个.md测试文件都会被 test/markdownlint-test-scenarios.mjs 中的createTestForFile读取并执行 lint、applyFixes再与快照文件 test/markdownlint-test-scenarios.mjs.snapshot 比对。其中prettier-tab-width-4.md对应的快照结果为{ errors: [], fixed: # Prettier --tab-width4\n\nText\n\n- Item\n - Item\n... }errors: []在文件内联配置生效后五种列表结构全部通过校验零告警fixed与原文完全一致无需任何自动修复证明配置已与 Prettier 输出完全对齐。对照 test/prettier-tab-width-2-default.md--tab-width2默认场景的快照同样是errors: []两者共同验证了 markdownlint 默认配置与--tab-width2兼容、经本文配置后与--tab-width4兼容的结论。实操清单三步完成兼容配置确定 Prettier 的 tab-width--tab-width2为默认值无需任何 markdownlint 调整--tab-width4时按下文配置。写入配置将上文 JSON 片段放入 markdownlint 配置文件或如测试夹具所示在文件顶部/底部用markdownlint-configure-file注释做单文件内联配置。验证运行 markdownlint 确认零告警若使用 CLI 的--fix或 API 的applyFixes用法见 README.md 的 Fixing 一节自动修复也不会改动 Prettier 已格式化的内容。延伸与prettier.json预置样式的取舍如果团队希望彻底避免规则冲突可以直接在配置中extendstyle/prettier.json。该文件以注释形式说明了用途Disables rules that may conflict with Prettier将blanks-around-lists、code-fence-style、list-marker-space、ul-indent、line-length等 22 条规则全部置false。两条路线对比extendprettier.json放弃全部重叠规则的检查简单彻底适合完全信任 Prettier 输出本文的精调方案保留列表规则仅调整参数适配--tab-width4lint 能力更完整适合希望列表结构仍受约束的团队。无论选择哪条路线--tab-width4都是唯一需要额外配置参数的非默认场景其余 Prettier 选项如--prose-wrap、--print-width不会与 markdownlint 的默认配置产生列表类冲突。赞分享开发工具代码质量Lint静态分析【免费下载链接】markdownlintA Node.js style checker and lint tool for Markdown/CommonMark files.项目地址https://gitcode.com/gh_mirrors/ma/markdownlint点击查看免费下载相关推荐markdownlint 与 Prettier 搭配使用指南规则冲突消除与列表缩进配置markdownlint 与 Prettier 搭配使用指南规则冲突消除与列表缩进配置 markdownlint 是面向 Node.js 的 Markdown开发工具代码质量Lint静态分析markdownlint 的 MD007ul-indent无序列表缩进规则4 空格缩进场景的机制与测试用例解析markdownlint 的 MD007ul indent无序列表缩进规则4 空格缩进场景的机制与测试用例解析 markdownlint 是面向 Mark开发工具代码质量Lint静态分析markdownlint MD007ul-indent规则详解无序列表缩进的配置、参数与源码实现原理markdownlint MD007ul indent规则详解无序列表缩进的配置、参数与源码实现原理在团队协作中嵌套无序列表的缩进宽度2 空格还是开发工具代码质量Lint静态分析上一篇Modin 革命高性能分布式 DataFrame 库如何重塑 Pandas 并行计算生态下一篇MFE-starter性能优化Ahead of Time编译实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

markdownlint 与 Prettier `--tab-width=4` 的列表缩进配置实战

相关推荐

Buzz 离线转录完整指南：100 种语言，本地快速转出字幕

C++存储持续性深度解析：从悬垂指针到生命周期陷阱的排查指南

PyQt源码实战：拆解经典项目，搞定信号槽与老代码迁移

更多资讯

27B 硬刚千亿参数：Hemmingway-1 用十分之一参数打的写作仗

SpringBoot+Vue+MySQL宠物猫认养系统全栈实战与部署指南

PR曲线与ROC曲线的本质区别及业务选型指南

韦达定理如何解码矩阵的迹与行列式

校园网生成树协议实战：环路排查与RSTP/MSTP调优指南

2026年9月望京GEO公司哪家懂婚介相亲？该比哪几项

今日更新

Cephadm实战指南：Linux系统工程师的生产级Ceph集群部署与排障

不想再被 Token 额度卡脖子？把免费 API 接入 WorkBuddy 的完整教程

ITK中SpatialObject几何体系解析：坐标系、变换与管道集成

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？