![Black Lives Matter!][x-badge-blm-image] [![Last commit timestamp][x-badge-lastcommit-image]][x-badge-repo-link] ![Codecov][x-badge-codecov-image] [![Source license][x-badge-license-image]][x-badge-license-link] [![Monthly Downloads][x-badge-downloads-image]][x-badge-npm-link] [![NPM version][x-badge-npm-image]][x-badge-npm-link] [![Uses Semantic Release!][x-badge-semanticrelease-image]][x-badge-semanticrelease-link]

remark-lint-fenced-code-flag-case

This is a remark-lint rule to warn when fenced code blocks have inconsistent or improperly cased language flags. Also comes with full unicode support.

This check is useful when using [a tool like prettier that formats fenced code blocks][2], since such tools do not consistently recognize uppercase or mixed-case code flags. That is: code fenced with the flag typescript or markdown will be formatted while code fenced with the flag TypeScript or MARKDOWN may be silently ignored, even as syntax highlighting still works, which results in a false sense of correctness.

Install

Due to the nature of the unified ecosystem, this package is ESM only and cannot be require'd.

npm install --save-dev remark-lint-fenced-code-flag-case

Usage

Via API

import { read } from 'to-vfile';
import { reporter } from 'vfile-reporter';
import { remark } from 'remark';
import remarkLint from 'remark-lint';
import lintFencedCodeFlagCase from 'remark-lint-fenced-code-flag-case';

const file = await remark()
  .use(remarkLint)
  .use(lintFencedCodeFlagCase)
  .process(await read('example.md'));

console.log(reporter(file));

Via remark-cli

remark --use remark-lint --use lint-fenced-code-flag-case README.md

Via unified configuration

In package.json:

  /* … */
  "remarkConfig": {
    "plugins": [
      "remark-lint-fenced-code-flag-case"
      /* … */
    ]
  },
  /* … */

In .remarkrc.js:

module.exports = {
  plugins: [
    // …
    'lint-fenced-code-flag-case'
  ]
};

In .remarkrc.mjs:

import lintFencedCodeFlagCase from 'remark-lint-fenced-code-flag-case';

export default {
  plugins: [
    // …
    lintFencedCodeFlagCase
  ]
};

API

Detailed interface information can be found under docs/.

Options

This rule supports standard configuration that all remark lint rules accept (such as false to turn it off or [1, options] to configure it).

Additionally, this plugin recognizes the following options:

`case`

Valid values: "lower" | "upper" | "capitalize"\ Default: "lower"

All code fence flags must be of the specified case. Code fences without flags are ignored.

Examples

`ok-missing.md`

In

# Document

```
Text.
```

Out

No messages.

`ok-lower.md`

In

# Document

```js
const str = 'string';
```

```javascript
const str = 'string';
```

Out

No messages.

`not-ok-mixed.md`

In

# Document

```Js
const str = 'string';
```

```JavaScript
const str = 'string';
```

Out

3:1-5:4: Code fence flag "Js" should be "js"
7:1-10:5: Code fence flag "JavaScript" should be "javascript"

`not-ok-upper.md`

In

# Document

```JS
const str = 'string';
```

```JAVASCRIPT
const str = 'string';
```

Out

3:1-5:4: Code fence flag "JS" should be "js"
7:1-10:5: Code fence flag "JAVASCRIPT" should be "javascript"

[remark-lint-fenced-code-flag][4] — warn when fenced code blocks occur without language flag.
[remark-lint-fenced-code-marker][5] — warn when fenced code markers violate the given style.

Contributing and Support

[New issues][x-repo-choose-new-issue] and pull requests are always welcome and greatly appreciated! 🤩 Just as well, you can [star 🌟 this project][x-badge-repo-link] to let me know you found it useful! ✊🏿 Thank you!

See CONTRIBUTING.md and SUPPORT.md for more information.

Contributors

See the table of contributors.

[x-badge-blm-image]: https://xunn.at/badge-blm 'Join the movement!'

[x-badge-codecov-image]: https://img.shields.io/codecov/c/github/Xunnamius/unified-utils/main?style=flat-square&token=HWRIOBAAPW 'Is this package well-tested?'

[x-badge-downloads-image]: https://img.shields.io/npm/dm/remark-lint-fenced-code-flag-case?style=flat-square 'Number of times this package has been downloaded per month' [x-badge-lastcommit-image]: https://img.shields.io/github/last-commit/xunnamius/unified-utils?style=flat-square 'Latest commit timestamp' [x-badge-license-image]: https://img.shields.io/npm/l/remark-lint-fenced-code-flag-case?style=flat-square "This package's source license" [x-badge-license-link]: https://github.com/Xunnamius/unified-utils/blob/main/packages/remark-lint-fenced-code-flag-case/LICENSE [x-badge-npm-image]: https://xunn.at/npm-pkg-version/remark-lint-fenced-code-flag-case 'Install this package using npm or yarn!' [x-badge-npm-link]: https://www.npmjs.com/package/remark-lint-fenced-code-flag-case [x-badge-repo-link]: https://github.com/xunnamius/unified-utils/blob/main/packages/remark-lint-fenced-code-flag-case [x-badge-semanticrelease-image]: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=flat-square 'This repo practices continuous integration and deployment!' [x-badge-semanticrelease-link]: https://github.com/semantic-release/semantic-release [x-repo-choose-new-issue]: https://github.com/xunnamius/unified-utils/issues/new/choose

[2]: https://prettier.io/blog/2017/11/07/1.8.0.html#support-markdown-2943httpsgithubcomprettierprettierpull2943-by-ikatyanghttpsgithubcomikatyang

[4]: https://github.com/remarkjs/remark-lint/tree/main/packages/remark-lint-fenced-code-flag [5]: https://github.com/remarkjs/remark-lint/tree/main/packages/remark-lint-fenced-code-marker

包详细信息