markdownlint

markdownlint 是用于 markdown 文件 的代码检查工具。

安装

首先你需要安装 markdownlint-cli。目前支持 markdownlint-cli v0.39。

npm

npm install markdownlint-cli -D

yarn

yarn add markdownlint-cli -D

pnpm

pnpm install markdownlint-cli -D

bun(experimental)

bun install markdownlint-cli -d

配置

JSON

更新你的 .markdownlint.json。

{
  "$schema": "https://raw.githubusercontent.com/DavidAnson/markdownlint/main/schema/markdownlint-config-schema.json",
  "extends": "@modyqyw/fabric/markdownlint.json"
}

CLI

更新你的 package.json，增加 lint:markdownlint 命令。

{
  "scripts": {
    "lint:markdownlint": "markdownlint . --fix --ignore-path=.gitignore"
  }
}

整合

VSC

先安装 对应的 markdownlint 插件。

视实际情况修改 用户设置 或 工作区设置。

{
  // markdown 手动保存后 markdownlint 自动修复
  "[markdown]": {
    "editor.codeActionsOnSave": {
      "source.fixAll.markdownlint": "explicit"
    }
  }
}

WebStorm

WebStorm 可以使用 插件 以获取 markdownlint 支持。

lint-staged

如果你使用该库提供的 lint-staged 配置，请查看 lint-staged 章节。

如果你没有使用该库提供的 lint-staged 配置，可以参考以下配置。

// lint-staged.config.mjs
// or lint-staged.config.js with "type": "module" in package.json
export default {
  '*.md': 'markdownlint --fix --ignore-path=.gitignore',
};