Skip to content

Releases: eslint/eslint-plugin-markdown

v2.0.0-rc.2

31 Jan 04:09
Compare
Choose a tag to compare
v2.0.0-rc.2 Pre-release
Pre-release
  • f6a3fad Fix: overrides pattern for virtual filenames in recommended config (#169) (Milos Djermanovic)

Migrating from eslint-plugin-markdown v1

  1. Install this release candidate:

    $ npm install --save-dev eslint@latest eslint-plugin-markdown@next
  2. In your .eslintrc.js file, extend the recommended config:

     // .eslintrc.js
     module.exports = {
    -    plugins: ["markdown"],
    -    overrides: [
    -        {
    -            files: ["**/*.md"],
    -            parserOptions: {
    -                ecmaFeatures: {
    -                    impliedStrict: true
    -                }
    -            },
    -        }
    -    ]
    +    extends: "plugin:markdown/recommended"
     };

The readme's detailed migration instructions discuss all of the differences between v1 and v2.

v2.0.0-rc.1

20 Dec 20:47
Compare
Choose a tag to compare
v2.0.0-rc.1 Pre-release
Pre-release
  • 1dd7089 Fix: npm prepare script on Windows (refs #166) (#168) (Brandon Mills)
  • 23ac2b9 Fix: Ignore words in info string after syntax (fixes #166) (#167) (Brandon Mills)
  • 8f729d3 Chore: Switch to main for primary branch (fixes #161) (#165) (Brandon Mills)
  • d30c50f Chore: Automatically install example dependencies (#164) (Brandon Mills)

Migrating from eslint-plugin-markdown v1

  1. Install this release candidate:

    $ npm install --save-dev eslint@latest eslint-plugin-markdown@next
  2. In your .eslintrc.js file, extend the recommended config:

     // .eslintrc.js
     module.exports = {
    -    plugins: ["markdown"],
    -    overrides: [
    -        {
    -            files: ["**/*.md"],
    -            parserOptions: {
    -                ecmaFeatures: {
    -                    impliedStrict: true
    -                }
    -            },
    -        }
    -    ]
    +    extends: "plugin:markdown/recommended"
     };

The readme's detailed migration instructions discuss all of the differences between v1 and v2.

v2.0.0-rc.0

20 Aug 03:58
Compare
Choose a tag to compare
v2.0.0-rc.0 Pre-release
Pre-release
  • d94c22f Build: Install example test dependencies in Jenkins (#160) (Brandon Mills)
  • 7f26cb9 Docs: Reference recommended config disabled rules (#159) (Brandon Mills)
  • bf7648f Docs: Add TypeScript example (#155) (Brandon Mills)
  • d80be9e New: Add rules to recommended config (#157) (Nikolay Stoynov)
  • fc4d7aa Chore: run CI in Node 14.x (#158) (Kai Cataldo)
  • f2d4923 Docs: Add React example (#152) (Brandon Mills)
  • eb66833 New: Add recommended config (fixes #151) (#153) (Brandon Mills)
  • 0311640 Fix: Don't require message end locations (fixes #112) (#154) (Brandon Mills)

Migrating from eslint-plugin-markdown v1

  1. Install this release candidate:

    $ npm install --save-dev eslint@latest eslint-plugin-markdown@next
  2. In your .eslintrc.js file, extend the recommended config:

     // .eslintrc.js
     module.exports = {
    -    plugins: ["markdown"],
    -    overrides: [
    -        {
    -            files: ["**/*.md"],
    -            parserOptions: {
    -                ecmaFeatures: {
    -                    impliedStrict: true
    -                }
    -            },
    -        }
    -    ]
    +    extends: "plugin:markdown/recommended"
     };

The readme's detailed migration instructions discuss all of the differences between v1 and v2.

v2.0.0-alpha.0

12 Apr 20:25
Compare
Choose a tag to compare
v2.0.0-alpha.0 Pre-release
Pre-release
  • 51e48c6 Docs: Revamp documentation for v2 (#149) (Brandon Mills)
  • b221391 Docs: Dogfood plugin by linting readme (#145) (Brandon Mills)
  • 7423610 Docs: Explain use of --ext option in ESLint v7 (#146) (Brandon Mills)
  • 0d4dbe8 Breaking: Implement new processor API (fixes #138) (#144) (Brandon Mills)
  • 7eeafb8 Chore: Update ESLint config and plugins (#143) (Brandon Mills)
  • f483343 Breaking: Require ESLint v6 (#142) (Brandon Mills)
  • 9aa1fdc Chore: Use ES2018 object spread syntax (#141) (Brandon Mills)
  • f584cc6 Build: Remove Travis (#140) (Brandon Mills)
  • 35f9a11 Breaking: Drop support for Node.js v6 (refs #138) (#137) (Brandon Mills)
  • 6f02ef5 Chore: Add npm version and build status badges (#139) (Brandon Mills)

Migrating from eslint-plugin-markdown v1

eslint-plugin-markdown v1 used an older version of ESLint's processor API.
The Markdown processor automatically ran on .md, .mkdn, .mdown, and .markdown files, and it only extracted fenced code blocks marked with js, javascript, jsx, or node syntax.
Configuration specifically for fenced code blocks went inside an overrides entry with a files pattern matching the containing Markdown document's filename that applied to all fenced code blocks inside the file.

// .eslintrc.js for eslint-plugin-markdown v1
module.exports = {
    plugins: ["markdown"],
    overrides: [
        {
            files: ["**/*.md"],
            // In v1, configuration for fenced code blocks went inside an
            // `overrides` entry with a .md pattern, for example:
            parserOptions: {
                ecmaFeatures: {
                    impliedStrict: true
                }
            },
            rules: {
                "no-console": "off"
            }
        }
    ]
};

RFC3 designed a new processor API to remove these limitations, and the new API was implemented as part of ESLint v6.
eslint-plugin-markdown v2 uses this new API.

$ npm install --save-dev eslint@latest eslint-plugin-markdown@next

All of the Markdown file extensions that were previously hard-coded are now fully configurable in .eslintrc.js.
Use the new processor option to apply the markdown/markdown processor on any Markdown documents matching a files pattern.
Each fenced code block inside a Markdown document has a virtual filename appended to the Markdown file's path.
The virtual filename's extension will match the fenced code block's syntax tag, so for example, ```js code blocks in README.md would match README.md/*.js.

// eslintrc.js for eslint-plugin-markdown v2
module.exports = {
    plugins: ["markdown"],
    overrides: [
        {
            // In v2, explicitly apply eslint-plugin-markdown's `markdown`
            // processor on any Markdown files you want to lint.
            files: ["**/*.md"],
            processor: "markdown/markdown"
        },
        {
            // In v2, configuration for fenced code blocks is separate from the
            // containing Markdown file. Each code block has a virtual filename
            // appended to the Markdown file's path.
            files: ["**/*.md/*.js"],
            // Configuration for fenced code blocks goes with the override for
            // the code block's virtual filename, for example:
            parserOptions: {
                ecmaFeatures: {
                    impliedStrict: true
                }
            },
            rules: {
                "no-console": "off"
            }
        }
    ]
};

If you need to precisely mimic the behavior of v1 with the hard-coded Markdown extensions and fenced code block syntaxes, you can use those as glob patterns in overrides[].files:

// eslintrc.js for v2 mimicking v1 behavior
module.exports = {
    plugins: ["markdown"],
    overrides: [
        {
            files: ["**/*.{md,mkdn,mdown,markdown}"],
            processor: "markdown/markdown"
        },
        {
            files: ["**/*.{md,mkdn,mdown,markdown}/*.{js,javascript,jsx,node}"]
            // ...
        }
    ]
};

v1.0.2

24 Feb 16:32
Compare
Choose a tag to compare
  • 52e0984 Upgrade: Update devDeps and change istanbul -> nyc (#130) (Brett Zamir)
  • d52988f Chore: Remove call to lint absent Makefile.js (#129) (Brett Zamir)
  • 5640ea6 Fix: Apply base indent to multiple line breaks (fixes #127) (#128) (Brett Zamir)

v1.0.1

22 Oct 03:49
Compare
Choose a tag to compare

v1.0.0

02 Jan 19:24
Compare
Choose a tag to compare
  • 2a8482e Fix: overrides general docs and Atom linter-eslint tips (fixes #109) (#111) (Brett Zamir)

v1.0.0-rc.1

06 Nov 02:27
Compare
Choose a tag to compare
v1.0.0-rc.1 Pre-release
Pre-release
  • a2f4492 Fix: Allowing eslint-plugin-prettier to work (fixes #101) (#107) (simlu)

v1.0.0-rc.0

27 Oct 20:11
Compare
Choose a tag to compare
v1.0.0-rc.0 Pre-release
Pre-release

v1.0.0-beta.8

08 Apr 21:20
Compare
Choose a tag to compare
v1.0.0-beta.8 Pre-release
Pre-release
  • a1544c2 Chore: Add .npmrc to disable creating package-lock.json (#90) (Brandon Mills)
  • 47ad3f9 Chore: Replace global comment integration test with unit test (refs #81) (#85) (Brandon Mills)
  • e34acc6 Fix: Add unicode-bom to unsatisfiable rules (refs #75) (#84) (Brandon Mills)
  • 7c19f8b Fix: Support globals (fixes #79) (#81) (Anders D. Johnson)