JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 19637
  • Score
    100M100P100Q139300F
  • License MIT

Eslint plugin for markdownlint

Package Exports

  • eslint-plugin-markdownlint
  • eslint-plugin-markdownlint/index.js
  • eslint-plugin-markdownlint/parser
  • eslint-plugin-markdownlint/parser.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (eslint-plugin-markdownlint) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

eslint-plugin-markdownlint

Eslint plugin which runs markdownlint.

npm version License: MIT

Install

npm install eslint-plugin-markdownlint --save-dev

Usage

Flat configs

import markdownlintPlugin from "eslint-plugin-markdownlint";
import markdownlintParser from "eslint-plugin-markdownlint/parser";

export default [
    // other configs,
  {
    files: ['**/*md'],
    plugins: {
      'markdownlint': markdownlintPlugin
    },
    languageOptions: {
      parser: markdownlintParser
    },
    rules: {
      ...markdownlintPlugin.configs.recommended.rules
    }
  }
]

Legacy .eslintrc

In order to use this plugin there is required to put it into override section of .eslintrc file with defined files array (select markdown files), parser and rules.

Recommended config enable all options except deprecated, all with default values and reported as error.

{
  "overrides": [{
    "files": ["*.md"],
    "parser": "eslint-plugin-markdownlint/parser",
    "extends": ["plugin:markdownlint/recommended"]
  }]
}

If you want to modify recommended rules simply add related rule to the rules section.

{
  "overrides": [{
    "files": ["*.md"],
    "parser": "eslint-plugin-markdownlint/parser",
    "extends": ["plugin:markdownlint/recommended"],
    "rules": {
      "markdownlint/md001": "off",
      "markdownlint/md003": "warn",
      "markdownlint/md025": ["error", {
        "level": 2
      }]
    }
  }]
}

If you want to configure all settings manually, ommit "extends": ["plugin:markdownlint/recommended"] (all rules will be set to 'off'), then enable/configure requested rules in "rules" section.

It's worth to define separate entry in .editorconfig if you're using it. Following example uses default settings.

[*.md]
max_line_length = 80
indent_style = space
insert_final_newline = true
trim_trailing_whitespace = true

Limitations

This plugin is in early stage of development, so:

  • there isn't supported any config file like .mdlrc
  • aliases for rules are not supported, you need to use codes like mdXXX to select rule, but should be available in future
  • tags are not supported and there is no plans to support it

Markdownlint

For full documentation about markdownlint refer DavidAnson/markdownlint