2017-02-23 20:07:52 +03:00
|
|
|
<!--This file is generated-->
|
|
|
|
|
|
|
|
# remark-lint-fenced-code-marker
|
|
|
|
|
2019-06-20 12:42:27 +03:00
|
|
|
[![Build][build-badge]][build]
|
|
|
|
[![Coverage][coverage-badge]][coverage]
|
|
|
|
[![Downloads][downloads-badge]][downloads]
|
|
|
|
[![Size][size-badge]][size]
|
|
|
|
[![Sponsors][sponsors-badge]][collective]
|
|
|
|
[![Backers][backers-badge]][collective]
|
|
|
|
[![Chat][chat-badge]][chat]
|
|
|
|
|
2017-02-23 20:07:52 +03:00
|
|
|
Warn for violating fenced code markers.
|
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
Options: ``'`'``, `'~'`, or `'consistent'`, default: `'consistent'`.
|
2017-02-23 20:07:52 +03:00
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
`'consistent'` detects the first used fenced code marker style and warns
|
2019-06-20 11:51:46 +03:00
|
|
|
when subsequent fenced code blocks use different styles.
|
2017-02-23 20:07:52 +03:00
|
|
|
|
2017-09-02 18:26:54 +03:00
|
|
|
## Fix
|
|
|
|
|
2020-06-23 13:00:43 +03:00
|
|
|
[`remark-stringify`](https://github.com/remarkjs/remark/tree/HEAD/packages/remark-stringify)
|
2019-06-20 11:51:46 +03:00
|
|
|
formats fences using ``'`'`` (grave accent) by default.
|
|
|
|
Pass
|
2020-06-23 13:00:43 +03:00
|
|
|
[`fence: '~'`](https://github.com/remarkjs/remark/tree/HEAD/packages/remark-stringify#optionsfence)
|
2019-06-20 11:51:46 +03:00
|
|
|
to use `~` (tilde) instead.
|
2017-09-02 18:26:54 +03:00
|
|
|
|
2019-06-20 11:51:46 +03:00
|
|
|
See [Using remark to fix your Markdown](https://github.com/remarkjs/remark-lint#using-remark-to-fix-your-markdown)
|
2017-09-02 18:26:54 +03:00
|
|
|
on how to automatically fix warnings for this rule.
|
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
## Presets
|
2017-02-23 20:07:52 +03:00
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
This rule is included in the following presets:
|
|
|
|
|
|
|
|
| Preset | Setting |
|
2020-03-30 15:11:23 +03:00
|
|
|
| - | - |
|
2020-06-23 13:00:43 +03:00
|
|
|
| [`remark-preset-lint-consistent`](https://github.com/remarkjs/remark-lint/tree/main/packages/remark-preset-lint-consistent) | `'consistent'` |
|
|
|
|
| [`remark-preset-lint-markdown-style-guide`](https://github.com/remarkjs/remark-lint/tree/main/packages/remark-preset-lint-markdown-style-guide) | ``'`'`` |
|
2017-02-23 20:07:52 +03:00
|
|
|
|
|
|
|
## Example
|
|
|
|
|
2020-03-24 13:35:17 +03:00
|
|
|
##### `ok.md`
|
2017-08-17 14:52:59 +03:00
|
|
|
|
|
|
|
###### In
|
2017-02-23 20:07:52 +03:00
|
|
|
|
|
|
|
```markdown
|
|
|
|
Indented code blocks are not affected by this rule:
|
|
|
|
|
|
|
|
bravo();
|
|
|
|
```
|
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
###### Out
|
2017-02-23 20:07:52 +03:00
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
No messages.
|
|
|
|
|
2020-03-24 16:27:12 +03:00
|
|
|
##### `not-ok-consistent-tick.md`
|
2017-08-17 14:52:59 +03:00
|
|
|
|
|
|
|
###### In
|
2017-02-23 20:07:52 +03:00
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
````markdown
|
2018-05-17 23:12:24 +03:00
|
|
|
```alpha
|
|
|
|
bravo();
|
|
|
|
```
|
2017-02-23 20:07:52 +03:00
|
|
|
|
2018-05-17 23:12:24 +03:00
|
|
|
~~~
|
|
|
|
charlie();
|
|
|
|
~~~
|
2017-02-23 20:07:52 +03:00
|
|
|
````
|
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
###### Out
|
|
|
|
|
2017-02-23 20:07:52 +03:00
|
|
|
```text
|
2020-03-24 16:27:12 +03:00
|
|
|
5:1-7:4: Fenced code should use `` ` `` as a marker
|
|
|
|
```
|
|
|
|
|
|
|
|
##### `not-ok-consistent-tilde.md`
|
|
|
|
|
|
|
|
###### In
|
|
|
|
|
|
|
|
````markdown
|
|
|
|
~~~alpha
|
|
|
|
bravo();
|
|
|
|
~~~
|
|
|
|
|
|
|
|
```
|
|
|
|
charlie();
|
|
|
|
```
|
|
|
|
````
|
|
|
|
|
|
|
|
###### Out
|
|
|
|
|
|
|
|
```text
|
|
|
|
5:1-7:4: Fenced code should use `~` as a marker
|
2017-02-23 20:07:52 +03:00
|
|
|
```
|
|
|
|
|
2020-03-24 13:35:17 +03:00
|
|
|
##### `ok.md`
|
2017-02-23 20:07:52 +03:00
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
When configured with ``'`'``.
|
|
|
|
|
|
|
|
###### In
|
2017-02-23 20:07:52 +03:00
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
````markdown
|
2018-05-17 23:12:24 +03:00
|
|
|
```alpha
|
|
|
|
bravo();
|
|
|
|
```
|
2017-02-23 20:07:52 +03:00
|
|
|
|
2018-05-17 23:12:24 +03:00
|
|
|
```
|
|
|
|
charlie();
|
|
|
|
```
|
2017-02-23 20:07:52 +03:00
|
|
|
````
|
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
###### Out
|
2017-02-23 20:07:52 +03:00
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
No messages.
|
|
|
|
|
2020-03-24 13:35:17 +03:00
|
|
|
##### `ok.md`
|
2017-02-23 20:07:52 +03:00
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
When configured with `'~'`.
|
|
|
|
|
|
|
|
###### In
|
|
|
|
|
|
|
|
```markdown
|
2018-05-17 23:12:24 +03:00
|
|
|
~~~alpha
|
|
|
|
bravo();
|
|
|
|
~~~
|
2017-02-23 20:07:52 +03:00
|
|
|
|
2018-05-17 23:12:24 +03:00
|
|
|
~~~
|
|
|
|
charlie();
|
|
|
|
~~~
|
2017-02-23 20:07:52 +03:00
|
|
|
```
|
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
###### Out
|
|
|
|
|
|
|
|
No messages.
|
|
|
|
|
2020-03-24 16:27:12 +03:00
|
|
|
##### `not-ok-incorrect.md`
|
2017-08-17 14:52:59 +03:00
|
|
|
|
2020-03-24 13:35:17 +03:00
|
|
|
When configured with `'💩'`.
|
2017-08-17 14:52:59 +03:00
|
|
|
|
|
|
|
###### Out
|
2017-02-23 20:07:52 +03:00
|
|
|
|
|
|
|
```text
|
2020-03-24 13:35:17 +03:00
|
|
|
1:1: Incorrect fenced code marker `💩`: use either `'consistent'`, `` '`' ``, or `'~'`
|
2017-02-23 20:07:52 +03:00
|
|
|
```
|
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
## Install
|
|
|
|
|
2019-06-20 12:42:27 +03:00
|
|
|
[npm][]:
|
|
|
|
|
2017-08-17 14:52:59 +03:00
|
|
|
```sh
|
|
|
|
npm install remark-lint-fenced-code-marker
|
|
|
|
```
|
|
|
|
|
2019-06-20 12:42:27 +03:00
|
|
|
## Use
|
2017-08-17 14:52:59 +03:00
|
|
|
|
|
|
|
You probably want to use it on the CLI through a config file:
|
|
|
|
|
|
|
|
```diff
|
2020-03-24 13:35:17 +03:00
|
|
|
…
|
2017-08-17 14:52:59 +03:00
|
|
|
"remarkConfig": {
|
|
|
|
"plugins": [
|
2020-03-24 13:35:17 +03:00
|
|
|
…
|
2017-08-17 14:52:59 +03:00
|
|
|
"lint",
|
|
|
|
+ "lint-fenced-code-marker",
|
2020-03-24 13:35:17 +03:00
|
|
|
…
|
2017-08-17 14:52:59 +03:00
|
|
|
]
|
|
|
|
}
|
2020-03-24 13:35:17 +03:00
|
|
|
…
|
2017-08-17 14:52:59 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
Or use it on the CLI directly
|
|
|
|
|
|
|
|
```sh
|
|
|
|
remark -u lint -u lint-fenced-code-marker readme.md
|
|
|
|
```
|
|
|
|
|
|
|
|
Or use this on the API:
|
|
|
|
|
|
|
|
```diff
|
2020-03-24 13:35:17 +03:00
|
|
|
var remark = require('remark')
|
|
|
|
var report = require('vfile-reporter')
|
2017-08-17 14:52:59 +03:00
|
|
|
|
|
|
|
remark()
|
|
|
|
.use(require('remark-lint'))
|
|
|
|
+ .use(require('remark-lint-fenced-code-marker'))
|
|
|
|
.process('_Emphasis_ and **importance**', function (err, file) {
|
2020-03-24 13:35:17 +03:00
|
|
|
console.error(report(err || file))
|
|
|
|
})
|
2017-08-17 14:52:59 +03:00
|
|
|
```
|
|
|
|
|
2019-06-20 12:42:27 +03:00
|
|
|
## Contribute
|
|
|
|
|
|
|
|
See [`contributing.md`][contributing] in [`remarkjs/.github`][health] for ways
|
|
|
|
to get started.
|
|
|
|
See [`support.md`][support] for ways to get help.
|
|
|
|
|
2020-03-24 13:35:17 +03:00
|
|
|
This project has a [code of conduct][coc].
|
|
|
|
By interacting with this repository, organization, or community you agree to
|
2019-06-20 12:42:27 +03:00
|
|
|
abide by its terms.
|
|
|
|
|
2017-02-23 20:07:52 +03:00
|
|
|
## License
|
|
|
|
|
2019-06-20 12:42:27 +03:00
|
|
|
[MIT][license] © [Titus Wormer][author]
|
|
|
|
|
2020-06-23 13:00:43 +03:00
|
|
|
[build-badge]: https://img.shields.io/travis/remarkjs/remark-lint/main.svg
|
2019-06-20 12:42:27 +03:00
|
|
|
|
|
|
|
[build]: https://travis-ci.org/remarkjs/remark-lint
|
|
|
|
|
|
|
|
[coverage-badge]: https://img.shields.io/codecov/c/github/remarkjs/remark-lint.svg
|
|
|
|
|
|
|
|
[coverage]: https://codecov.io/github/remarkjs/remark-lint
|
|
|
|
|
|
|
|
[downloads-badge]: https://img.shields.io/npm/dm/remark-lint-fenced-code-marker.svg
|
|
|
|
|
|
|
|
[downloads]: https://www.npmjs.com/package/remark-lint-fenced-code-marker
|
|
|
|
|
|
|
|
[size-badge]: https://img.shields.io/bundlephobia/minzip/remark-lint-fenced-code-marker.svg
|
|
|
|
|
|
|
|
[size]: https://bundlephobia.com/result?p=remark-lint-fenced-code-marker
|
|
|
|
|
|
|
|
[sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg
|
|
|
|
|
|
|
|
[backers-badge]: https://opencollective.com/unified/backers/badge.svg
|
|
|
|
|
|
|
|
[collective]: https://opencollective.com/unified
|
|
|
|
|
2020-03-24 13:35:17 +03:00
|
|
|
[chat-badge]: https://img.shields.io/badge/chat-spectrum.svg
|
2019-06-20 12:42:27 +03:00
|
|
|
|
|
|
|
[chat]: https://spectrum.chat/unified/remark
|
|
|
|
|
|
|
|
[npm]: https://docs.npmjs.com/cli/install
|
|
|
|
|
|
|
|
[health]: https://github.com/remarkjs/.github
|
|
|
|
|
2020-06-23 13:00:43 +03:00
|
|
|
[contributing]: https://github.com/remarkjs/.github/blob/HEAD/contributing.md
|
2019-06-20 12:42:27 +03:00
|
|
|
|
2020-06-23 13:00:43 +03:00
|
|
|
[support]: https://github.com/remarkjs/.github/blob/HEAD/support.md
|
2019-06-20 12:42:27 +03:00
|
|
|
|
2020-06-23 13:00:43 +03:00
|
|
|
[coc]: https://github.com/remarkjs/.github/blob/HEAD/code-of-conduct.md
|
2019-06-20 12:42:27 +03:00
|
|
|
|
2020-06-23 13:00:43 +03:00
|
|
|
[license]: https://github.com/remarkjs/remark-lint/blob/main/license
|
2019-06-20 12:42:27 +03:00
|
|
|
|
|
|
|
[author]: https://wooorm.com
|