Home

Awesome

Lint Markdown 2.0

⚠️ 提示：你现在看到的是 2.0 版本，如果要查看 1.x 版本请切换到 1.x 分支。

Lint Markdown 是检查中文 Markdown 编写格式的工具，让你的文档更加优雅规范。

npm npm

新版特点

重构文本修复算法，fix 能力性能提升上百倍。

底层 Markdown 解析库 remark 迁移至最新版。

支持多线程 lint & fix。

体验更好的命令行输出提示。

项目架构完全重构，代码质量大幅提升，更方便 contribute 😄。

快速开始

我们提供了两种使用的方式，命令行和 Node.js API，前者适合大部分用户使用（推荐），后者适合更加定制化的 Lint 需求。

使用命令行（CLI）

安装依赖

npm install -g @lint-md/cli

命令示例

# 校验当前目录下的 test.md 文件
lint-md test.md

# 校验当前目录下的 test.md 文件，并修复之
lint-md test.md --fix

# 校验 examples 目录下所有的 Markdown 文件，并修复之
lint-md examples/**/* --fix

# 校验 examples 目录下所有的 Markdown 文件，指定 config.json 为配置文件（配置文件语法见下文）
lint-md examples/**/* --config=config.json

# 校验 examples 目录下所有的 Markdown 文件，仅存在 warning 时程序正常退出（warning 不会阻断 CI）
lint-md examples/**/* --suppress-warnings

# 校验 examples 目录下所有的 Markdown 文件，并开启多线程模式（线程数 === CPU 核心数）
lint-md examples/**/* --threads

# 校验 examples 目录下所有的 Markdown 文件，并开启多线程模式（线程数 === 8）
lint-md examples/**/* --threads=8

配置文件

默认情况下重新会读取根目录下的 .lintmdrc JSON 文件（如果有的话），下面是一个案例，表示将 no-empty-code 这条规则的等级设置为 warning，同时为 no-long-code 这条规则配置了自定义的选项：

{
  "rules":{
    "no-empty-code": 1,
    "no-long-code": [2, {
      "length": 100,
      "exclude": ["dot"]
    }]
  }
}

其中 key 为对应规则的名称，value 是一个数字或者对象。

如果是一个数字，那么表示规则的等级：

如果是一个数组，那么数组的第一项为数字，表示该规则的等级；第二个为规则的配置参数。

API 一览

Options:
  -v, --version                  output the version number（查看当前版本）
  -c, --config [configure-file]  use the configure file, default .lintmdrc（使用配置文件，默认为 .lintmdrc）
  -f, --fix                      fix the errors automatically（开启修复模式）
  -d, --dev                      open dev mode（开启开发者模式）
  -t, --threads [thread-count]   The number of threads. The default is based on the number of available CPUs.（执行 Lint / Fix 的线程数，默认为 CPU 核心数）
  -s, --suppress-warnings        suppress all warnings, that means warnings will not block CI（抑制所有警告，这意味着警告不会阻止 CI）
  -h, --help                     display help for command（查看帮助）

使用 Node.js API

TODO

规则概述

检查规则来源于 chinese-document-style-guide.

规则详细描述解决办法可自动修复
space-around-alphabet中文与英文之间需要增加空格对应提示的位置增加空格✅
space-around-number中文与数字之间需要增加空格对应提示的位置增加空格✅
no-empty-code-lang代码语言不能为空在代码块语法上增加语言✅
no-empty-url链接和图片地址不能为空填写完整的 url，或者不使用链接和图片语法✅
no-empty-listlist 内容不能为空删除空的 list 或者补充内容✅
no-empty-code代码块内容不能为空删除空的代码块，或者填充代码内容✅
no-empty-inline-code行内代码块内容不能为空删除空的行内代码块，或者填充代码内容✅
no-empty-blockquote引用块内容不能为空删除空的引用块，或者填充内容✅
no-special-characters文本中不能有特殊字符可能是复制出来的特殊字符，删除特殊字符即可✅
use-standard-ellipsis使用标准规范的省略号使用标准规范的省略号‘……’ / ‘...’✅
no-fullwidth-number不能用全角数字注意输入法切换为半角输入✅
no-space-in-link链接前后不能有空格删除链接内容的前后空格✅
no-multiple-space-blockquote引用块头部和内容间只能有一个空格删除多余的空格✅
correct-title-trailing-punctuation标题末尾只能使用合适的标点符号（允许问号、叹号、省略号）删除标题最后不合法的标点符号✅
no-space-in-inline-code行内代码内容前后不能有空格删除行内代码中的前后空格✅
no-long-code代码块不能有过长的代码（代码长度可配置，见下文）对展示代码做格式上的修改x

可配置的规则

no-long-code 接受两个可配置参数：

贡献代码

目前仅仅检查了比较通用的类型，欢迎 Pull Request，在 rules 中增加自己的规则，注意：

License

MIT@hustcc.