Remark-preset-wooorm NPM

remark-preset-wooorm

My personal markdown (and prose) style.

What is this?

This is a preset for remark to check markdown. It’s used on all the readmes I work on.

When should I use this?

Feel free to use this. But you can also create your own personal style preset.

Install

This package is ESM only. In Node.js (version 16+), install with npm:

npm install remark-preset-wooorm

In Deno with esm.sh:

import remarkPresetWooorm from 'https://esm.sh/remark-preset-wooorm@10'

In browsers with esm.sh:

<script type="module">
  import remarkPresetWooorm from 'https://esm.sh/remark-preset-wooorm@10?bundle'
</script>

Use

import {remark} from 'remark'
import remarkPresetWooorm from 'remark-preset-wooorm'
import {reporter} from 'vfile-reporter'

const file = await remark()
  .use(remarkPresetWooorm)
  .process('This *and* _and_ that.')

console.error(reporter(file))

Yields:

1:7-1:16  warning Unexpected repeated `and`, remove one occurrence                                     and             retext-repeated-words
1:12-1:17 warning Unexpected emphasis marker `_`, expected `*`                                         emphasis-marker remark-lint
1:23      warning Unexpected missing final newline character, expected line feed (`\n`) at end of file final-newline   remark-lint

⚠ 3 warnings

API

This package exports no identifiers. The default export is remarkPresetWooorm. It exports no TypeScript types.

`remarkPresetWooorm`

Preset to support my personal markdown style (Preset).

Checks

Markdown

extends remark-preset-lint-recommended, and adds a strict code-style (see index.js)
checks broken local links
markdown is compiled with asterisks (*) for list-item bullets and emphasis, and fenced code blocks (note: set output: true in your config to benefit from this)
how remark compiles can be configured inline with comments
Contents headers are kept up to date, with a depth of 3 (if output: true)
GH references, like mentions or issue references, are linked (if output: true)

Natural language

See retext-preset-wooorm for more info.

English parsing
two spaces between sentences (but: prefer a line break instead!)
checks “indefinite articles”: “a” or “an”
checks quotes and apostrophes ("" > “”)
checks accidental repeated words
checks diacritics
checks redundant acronyms
checks incorrectly placed apostrophes in contractions

Compatibility

This projects is compatible with maintained versions of Node.js.

When we cut a new major release, we drop support for unmaintained versions of Node. This means we try to keep the current release line, remark-preset-wooorm@10, compatible with Node.js 16.