.github/workflows/main.yml

@@ -11,6 +11,7 @@ jobs:
       - uses: dcodeIO/setup-node-nvm@master
         with:
           node-version: ${{matrix.node}}
+      - run: npm install -g npm
       - run: npm install
       - run: npm test
       - uses: codecov/codecov-action@v1

doc/getting-started.md

@@ -1,227 +1,6 @@
-![remark][logo]
-
 # Getting started
 
-**remark** transforms markdown.
-It’s an ecosystem of [plugins][].
-If you get stuck, [issues][] and [Discussions][] are good places to get help.
-
-It’s built on [unified][], make sure to read it and its [website][] too.
-
-## Contents
-
-*   [Intro](#intro)
-*   [Command line](#command-line)
-*   [Using remark in a project](#using-remark-in-a-project)
-*   [Programmatic usage](#programmatic-usage)
-
-## Intro
-
-Out of the box, **remark** transforms markdown: markdown is given, reformatted,
-and written:
-
-```md
-# Alpha #
-Bravo charlie **delta** __echo__.
-- Foxtrot
-```
-
-Yields:
-
-```md
-# Alpha
-
-Bravo charlie **delta** **echo**.
-
-*   Foxtrot
-```
-
-But, much more can be done, [through plugins][plugins].
-
-## Command line
-
-**remark**’s CLI is a simple way to process markdown files from the
-command line.  Its interface is provided by [**unified-args**][unified-args].
-
-Install [`remark-cli`][cli] and dependencies (in this case a [linting
-preset][preset] and [`remark-html`][html]) with [npm][]:
-
-```sh
-npm install --global remark-cli remark-html remark-preset-lint-markdown-style-guide
-```
-
-`readme.md` contains:
-
-```md
-_Hello_.
-```
-
-Now, to process `readme.md`, run the following:
-
-```sh
-remark readme.md --use html --use preset-lint-markdown-style-guide
-```
-
-Yields:
-
-```txt
-<p><em>Hello</em>.</p>
-readme.md.md
-  1:1-1:8  warning  Emphasis should use `*` as a marker  emphasis-marker  remark-lint
-
-⚠ 1 warning
-```
-
-## Using remark in a project
-
-In the previous example, `remark-cli` was installed globally.
-That’s generally a bad idea.
-Here we’re going to use the CLI to lint an npm package.
-
-Say we have the following `package.json`:
-
-```json
-{
-  "name": "my-package",
-  "version": "1.0.0",
-  "type": "module",
-  "scripts": {
-    "test": "node test.js"
-  }
-}
-```
-
-And install `remark-cli`, `remark-html`, and
-`remark-preset-lint-markdown-style-guide` into it as a dev-dependencies:
-
-```sh
-npm install --save-dev remark-cli remark-html remark-preset-lint-markdown-style-guide
-```
-
-The `--save-dev` option stores the dependencies in our `package.json`:
-
-```diff
- {
-   "name": "my-package",
-   "version": "1.0.0",
-   "type": "module",
-+  "devDependencies": {
-+    "remark-cli": "^10.0.0",
-+    "remark-html": "^14.0.0",
-+    "remark-preset-lint-markdown-style-guide": "^5.0.0"
-+  },
-   "scripts": {
-     "test": "node test.js"
-   }
- }
-```
-
-Then, we change our `test` script to include remark, and add
-configuration:
-
-```diff
- {
-   "name": "my-package",
-   "version": "1.0.0",
-   "type": "module",
-   "devDependencies": {
-     "remark-cli": "^10.0.0",
-     "remark-html": "^14.0.0",
-     "remark-preset-lint-markdown-style-guide": "^5.0.0"
-   },
-   "scripts": {
--    "test": "node test.js"
-+    "test": "remark . --quiet --frail && node test.js"
-+  },
-+  "remarkConfig": {
-+    "plugins": [
-+      "preset-lint-markdown-style-guide",
-+      "html"
-+    ]
-   }
- }
-```
-
-Now from the command line we can run:
-
-```sh
-npm test
-```
-
-This will lint all markdown files when we test the project.
-[`--frail`][frail] ensures the command fails if a code-style violation
-is found, and [`--quiet`][quiet] hides successful files from the report.
-
-## Programmatic usage
-
-The programmatic interface of **remark** is provided by
-[**unified**][unified].
-In fact, [`remark`][api] is two plugins: [`remark-parse`][parse] and
-[`remark-stringify`][stringify].
-
-Install [`remark`][api] and dependencies with [npm][]:
-
-```sh
-npm install vfile-reporter remark remark-html remark-preset-lint-markdown-style-guide
-```
-
-`index.js` contains:
-
-```js
-import {reporter} from 'vfile-reporter'
-import {remark} from 'remark'
-import remarkPresetLintMarkdownStyleGuide from 'remark-preset-lint-markdown-style-guide'
-import remarkHtml from 'remark-html'
-
-remark()
-  .use(remarkPresetLintMarkdownStyleGuide)
-  .use(remarkHtml)
-  .process('_Hello_.')
-  .then((file) => {
-    console.error(reporter(file))
-    console.log(String(file))
-  })
-```
-
-`node index.js` yields:
-
-```txt
-  1:1-1:8  warning  Emphasis should use `*` as a marker  emphasis-marker  remark-lint
-
-⚠ 1 warning
-<p><em>Hello</em>.</p>
-```
-
-<!-- Definitions -->
-
-[logo]: https://raw.githubusercontent.com/remarkjs/remark/1f338e72/logo.svg?sanitize=true
-
-[issues]: https://github.com/remarkjs/remark/issues
-
-[discussions]: https://github.com/remarkjs/remark/discussions
-
-[npm]: https://docs.npmjs.com/cli/install
-
-[api]: https://github.com/remarkjs/remark/tree/main/packages/remark
-
-[cli]: https://github.com/remarkjs/remark/tree/main/packages/remark-cli
-
-[plugins]: https://github.com/remarkjs/remark/tree/main/doc/plugins.md
-
-[unified]: https://github.com/unifiedjs/unified
-
-[website]: https://unifiedjs.com
-
-[unified-args]: https://github.com/unifiedjs/unified-args
-
-[frail]: https://github.com/unifiedjs/unified-args#--frail
-
-[quiet]: https://github.com/unifiedjs/unified-args#--quiet
-
-[parse]: https://github.com/remarkjs/remark/tree/main/packages/remark-parse
-
-[stringify]: https://github.com/remarkjs/remark/tree/main/packages/remark-stringify
-
-[preset]: https://github.com/remarkjs/remark-lint/tree/HEAD/packages/remark-preset-lint-markdown-style-guide
+See [the monorepo readme][remark] for what the remark ecosystem is and examples
+of how to get started.
 
-[html]: https://github.com/remarkjs/remark-html
+[remark]: https://github.com/remarkjs/remark

doc/plugins.md

@@ -2,33 +2,33 @@
 
 # Plugins
 
-**remark** is a markdown processor powered by plugins part of the [unified][]
-[collective][].
+**remark** is a tool that transforms markdown with plugins.
+See [the monorepo readme][remark] for info on what the remark ecosystem is.
+This page lists existing plugins.
 
 ## Contents
 
 *   [List of plugins](#list-of-plugins)
 *   [List of presets](#list-of-presets)
 *   [List of utilities](#list-of-utilities)
-*   [Using plugins](#using-plugins)
-*   [Creating plugins](#creating-plugins)
+*   [Use plugins](#use-plugins)
+*   [Create plugins](#create-plugins)
 
 ## List of plugins
 
-See [awesome remark][awesome] for the most awesome projects in the ecosystem.
+See [`awesome-remark`][awesome-remark] for the most awesome projects in the
+ecosystem.
 More plugins can be found on GitHub tagged with the
 [`remark-plugin` topic][topic].
 
-Have a good idea for a new plugin?
-See [Creating plugins][create] below.
+> 👉 **Note**: some plugins don’t work with recent versions of remark due to
+> changes in its underlying parser (micromark).
+> Plugins that are up to date or unaffected are marked with `🟢` while plugins
+> that are **currently broken** are marked with `⚠️`.
 
-Some plugins are affected by the recent switch in the underlying parser of
-remark.
-Their status is encoded below as:
-
-*   🟢 This plugin **was not affected** or **a new version is already released**
-*   ⚠️ This plugin is affected: it’s **currently broken** and maintainers
-    have been notified
+> 💡 **Tip**: remark plugins work with markdown and **rehype** plugins work with
+> HTML.
+> See rehype’s [List of plugins][rehype-plugins] for more plugins.
 
 The list of plugins:
 
@@ -38,20 +38,20 @@ The list of plugins:
     — new syntax for abbreviations (new node type, rehype compatible)
 *   ⚠️ [`remark-admonitions`](https://github.com/elviswolcott/remark-admonitions)
     — new syntax for admonitions
-    (**note: [`remark-directive`][d] is similar and up to date**)
+    (👉 **note**: [`remark-directive`][d] is similar and up to date)
 *   ⚠️ [`remark-align`](https://github.com/zestedesavoir/zmarkdown/tree/HEAD/packages/remark-align#readme)
     — new syntax to align text or blocks (new node types, rehype
     compatible)
 *   ⚠️ [`remark-attr`](https://github.com/arobase-che/remark-attr)
     — new syntax to add attributes to markdown
-*   🟢 [`remark-autolink-headings`](https://github.com/remarkjs/remark-autolink-headings)
-    — add GitHub-style links to headings
 *   🟢 [`remark-behead`](https://github.com/mrzmmr/remark-behead)
     — increase or decrease heading depth
 *   🟢 [`remark-breaks`](https://github.com/remarkjs/remark-breaks)
     – hard breaks w/o needing spaces (like on issues)
 *   🟢 [`remark-capitalize`](https://github.com/zeit/remark-capitalize)
     – transform all titles w/ [`title.sh`](https://github.com/zeit/title)
+*   🟢 [`remark-cite`](https://github.com/benrbray/remark-cite)
+    – new syntax for Pandoc-style citations
 *   🟢 [`remark-code-blocks`](https://github.com/mrzmmr/remark-code-blocks)
     — select and store code blocks
 *   🟢 [`remark-code-extra`](https://github.com/samlanning/remark-code-extra)
@@ -72,48 +72,51 @@ The list of plugins:
     — new syntax to ignore things
 *   ⚠️ [`remark-container`](https://github.com/zWingz/remark-container)
     — new syntax for containers
-    (**note: [`remark-directive`][d] is similar and up to date**)
+    (👉 **note**: [`remark-directive`][d] is similar and up to date)
 *   ⚠️ [`remark-containers`](https://github.com/Nevenall/remark-containers)
     — new syntax for containers
-    (**note: [`remark-directive`][d] is similar and up to date**)
+    (👉 **note**: [`remark-directive`][d] is similar and up to date)
 *   🟢 [`remark-contributors`](https://github.com/remarkjs/remark-contributors)
     — add a table of contributors
 *   🟢 [`remark-copy-linked-files`](https://github.com/sergioramos/remark-copy-linked-files)
     — find and copy files linked files to a destination directory
 *   ⚠️ [`remark-custom-blocks`](https://github.com/zestedesavoir/zmarkdown/tree/HEAD/packages/remark-custom-blocks#readme)
     — new syntax for custom blocks (new node types, rehype compatible)
-    (**note: [`remark-directive`][d] is similar and up to date**)
+    (👉 **note**: [`remark-directive`][d] is similar and up to date)
+*   🟢 [`remark-definition-list`](https://github.com/wataru-chocola/remark-definition-list)
+    — support definition lists
 *   🟢 [`remark-defsplit`](https://github.com/remarkjs/remark-defsplit)
     — change links and images to references w/ separate definitions
 *   ⚠️ [`remark-disable-tokenizers`](https://github.com/zestedesavoir/zmarkdown/tree/HEAD/packages/remark-disable-tokenizers#readme)
     — turn some or all remark’s tokenizers on or off
 *   🟢 [`remark-directive`](https://github.com/remarkjs/remark-directive)
     — new syntax for directives (generic extensions)
+*   🟢 [`remark-directive-rehype`](https://github.com/IGassmann/remark-directive-rehype)
+    — turn [directives][d] into HTML custom elements (rehype compatible)
 *   🟢 [`remark-dropcap`](https://github.com/brev/remark-dropcap)
     — fancy and accessible drop caps
 *   🟢 [`remark-embed-images`](https://github.com/remarkjs/remark-embed-images)
     — embed local images as base64-encoded data URIs
 *   🟢 [`remark-emoji`](https://github.com/rhysd/remark-emoji)
     — transform Gemoji short-codes to emoji
-*   🟢 [`remark-external-links`](https://github.com/remarkjs/remark-external-links)
-    — add `target` and `rel` attributes to external links
+*   🟢 [`remark-extended-table`](https://github.com/wataru-chocola/remark-extended-table)
+    — extended table syntax allowing colspan / rowspan
 *   🟢 [`remark-extract-frontmatter`](https://github.com/mrzmmr/remark-extract-frontmatter)
     — store front matter in vfiles
 *   🟢 [`remark-first-heading`](https://github.com/laat/remark-first-heading)
     — change the first heading in a document
 *   🟢 [`remark-fix-guillemets`](https://github.com/zestedesavoir/zmarkdown/tree/HEAD/packages/remark-fix-guillemets#readme)
     — support ASCII guillements (`<<`, `>>`) mapping them to HTML
-*   🟢 [`remark-footnotes`](https://github.com/remarkjs/remark-footnotes)
-    – support pandoc footnotes
 *   🟢 [`remark-frontmatter`](https://github.com/remarkjs/remark-frontmatter)
     – support frontmatter (yaml, toml, and more)
 *   🟢 [`remark-gemoji`](https://github.com/remarkjs/remark-gemoji)
     — better support for Gemoji shortcodes
 *   ⚠️ [`remark-generic-extensions`](https://github.com/medfreeman/remark-generic-extensions)
     — new syntax for the CommonMark generic directive extension
-    (**note: [`remark-directive`][d] is similar and up to date**)
+    (👉 **note**: [`remark-directive`][d] is similar and up to date)
 *   🟢 [`remark-gfm`](https://github.com/remarkjs/remark-gfm)
-    — support GFM (tables, tasklists, strikethrough, autolink literals)
+    — support GFM (autolink literals, footnotes, strikethrough, tables,
+    tasklists)
 *   🟢 [`remark-git-contributors`](https://github.com/remarkjs/remark-git-contributors)
     — add a table of contributors based on Git history, options, and more
 *   🟢 [`remark-github`](https://github.com/remarkjs/remark-github)
@@ -131,8 +134,6 @@ The list of plugins:
     — add hints/tips/warnings to markdown
 *   🟢 [`remark-html`](https://github.com/remarkjs/remark-html)
     — serialize markdown as HTML
-*   🟢 [`remark-html-katex`](https://github.com/remarkjs/remark-math/tree/HEAD/packages/remark-html-katex#readme)
-    — change inline and block math to equations w/ [KaTeX](https://github.com/Khan/KaTeX)
 *   ⚠️ [`remark-iframes`](https://github.com/zestedesavoir/zmarkdown/tree/HEAD/packages/remark-iframes#readme)
     — new syntax to create iframes (new node type, rehype compatible)
 *   🟢 [`remark-images`](https://github.com/remarkjs/remark-images)
@@ -162,11 +163,10 @@ The list of plugins:
     — serialize markdown as man pages (roff)
 *   🟢 [`remark-math`](https://github.com/remarkjs/remark-math)
     — new syntax for math (new node types, rehype compatible)
+*   🟢 [`remark-mdx`](https://github.com/mdx-js/mdx/tree/main/packages/remark-mdx)
+    — support MDX (JSX, expressions, ESM)
 *   🟢 [`remark-message-control`](https://github.com/remarkjs/remark-message-control)
     — turn some or all messages on or off
-*   🟢 [`remark-midas`](https://github.com/remarkjs/remark-midas)
-    — highlight CSS code blocks w/ [midas](https://github.com/ben-eb/midas)
-    (rehype compatible)
 *   🟢 [`remark-normalize-headings`](https://github.com/remarkjs/remark-normalize-headings)
     — make sure at most one top-level heading exists
 *   🟢 [`remark-numbered-footnote-labels`](https://github.com/jackfletch/remark-numbered-footnote-labels)
@@ -186,10 +186,6 @@ The list of plugins:
 *   🟢 [`remark-prism`](https://github.com/sergioramos/remark-prism)
     — highlight code blocks w/ [Prism](https://prismjs.com/) (supporting most
     Prism plugins)
-*   🟢 [`remark-react`](https://github.com/remarkjs/remark-react)
-    — compile markdown to [React](https://github.com/facebook/react)
-*   🟢 [`remark-react-codemirror`](https://github.com/craftzdog/remark-react-codemirror)
-    — highlight code blocks for `remark-react` w/ [CodeMirror](https://codemirror.net)
 *   ⚠️ [`remark-redact`](https://github.com/seafoam6/remark-redact)
     — new syntax to conceal text matching a regex
 *   🟢 [`remark-redactable`](https://github.com/code-dot-org/remark-redactable)
@@ -212,16 +208,14 @@ The list of plugins:
     rehype compatible)
 *   ⚠️ [`remark-shortcodes`](https://github.com/djm/remark-shortcodes)
     — new syntax for Wordpress- and Hugo-like shortcodes (new node type)
-    (**note: [`remark-directive`][d] is similar and up to date**)
+    (👉 **note**: [`remark-directive`][d] is similar and up to date)
 *   🟢 [`remark-simple-plantuml`](https://github.com/akebifiky/remark-simple-plantuml)
     — turn PlantUML code blocks to images
 *   🟢 [`remark-slate`](https://github.com/hanford/remark-slate)
     — compile markdown to [Slate nodes](https://docs.slatejs.org/concepts/02-nodes)
 *   🟢 [`remark-slate-transformer`](https://github.com/inokawa/remark-slate-transformer)
     — compile markdown to [Slate nodes](https://docs.slatejs.org/concepts/02-nodes)
     and Slate nodes to markdown
-*   🟢 [`remark-slug`](https://github.com/remarkjs/remark-slug)
-    — add anchors to headings using GitHub’s algorithm
 *   🟢 [`remark-smartypants`](https://github.com/silvenon/remark-smartypants)
     — SmartyPants
 *   🟢 [`remark-smcat`](https://github.com/shedali/remark-smcat)
@@ -245,6 +239,8 @@ The list of plugins:
     — check and add the document title
 *   🟢 [`remark-toc`](https://github.com/remarkjs/remark-toc)
     — add a table of contents
+*   🟢 [`remark-torchlight`](https://github.com/torchlight-api/remark-torchlight)
+    — syntax highlighting powered by [torchlight.dev](https://torchlight.dev)
 *   🟢 [`remark-tree-sitter`](https://github.com/samlanning/remark-tree-sitter)
     — highlight code blocks in markdown files using
     [Tree-sitter](https://tree-sitter.github.io/tree-sitter/)
@@ -280,48 +276,56 @@ The list of plugins:
 
 ## List of presets
 
-See [npm search][npm-preset-search] or [github search][github-preset-search]
-for available and often inspirational presets.
+Use [GitHub search][github-preset-search] to find available and often
+inspirational presets.
 
 ## List of utilities
 
-See [**mdast**][mdast-util] for a list of utilities for working with the syntax
+See [mdast][mdast-util] for a list of utilities that work with the syntax
 tree.
-See [`unist`][unist-util] for other utilities which work with **mdast**
-nodes, too.
-Finally, see [**vfile**][vfile-util] for a list of utilities working with
-virtual files.
+See [unist][unist-util] for other utilities which work with **mdast** and other
+syntax trees too.
+Finally, see [vfile][vfile-util] for a list of utilities working with virtual
+files.
 
-## Using plugins
+## Use plugins
 
 To use a plugin programmatically, call the [`use()`][unified-use] function.
-
 To use plugin with `remark-cli`, pass a [`--use` flag][unified-args-use] or
 specify it in a [configuration file][config-file-use].
 
-## Creating plugins
-
-Have an idea for a plugin?
-Post it in [ideas][] and make it happen!
+## Create plugins
 
 To create a plugin, first read up on the [concept of plugins][unified-plugins].
 Then, read the [guide on “Creating a plugin with unified”][guide].
 Finally, take one of existing plugins, which looks similar to what you’re about
 to make, and work from there.
-If you get stuck, [ideas][], [issues][], and [discussions][] are good places to
-get help.
-
-You should pick a name prefixed by `'remark-'`, such as `remark-lint`.
+If you get stuck, [discussions][] is a good place to get help.
 
+You should pick a name prefixed by `'remark-'` (such as `remark-lint`).
 **Do not use the `remark-` prefix** if the thing you create doesn’t work with
 `remark().use()`: it isn’t a “plugin” and will confuse users.
 If it works with mdast, use `'mdast-util-'`, if it works with any unist tree,
 use `unist-util-`, and if it works with virtual files, use `vfile-`.
 
+Use default exports to expose plugins from your packages, add `remark-plugin`
+keywords in `package.json`, add a `remark-plugin` topic to your repo on GitHub,
+and create a pull request to add the plugin here on this page!
+
 <!--Definitions:-->
 
 [logo]: https://raw.githubusercontent.com/remarkjs/remark/1f338e72/logo.svg?sanitize=true
 
+[d]: https://github.com/remarkjs/remark-directive
+
+[remark]: https://github.com/remarkjs/remark
+
+[awesome-remark]: https://github.com/remarkjs/awesome-remark
+
+[topic]: https://github.com/topics/remark-plugin
+
+[github-preset-search]: https://github.com/topics/remark-preset
+
 [mdast-util]: https://github.com/syntax-tree/mdast#list-of-utilities
 
 [unist-util]: https://github.com/syntax-tree/unist#unist-utilities
@@ -336,26 +340,8 @@ use `unist-util-`, and if it works with virtual files, use `vfile-`.
 
 [unified-plugins]: https://github.com/unifiedjs/unified#plugin
 
-[issues]: https://github.com/remarkjs/remark/issues
-
-[discussions]: https://github.com/remarkjs/remark/discussions
-
 [guide]: https://unifiedjs.com/learn/guide/create-a-plugin/
 
-[npm-preset-search]: https://www.npmjs.com/search?q=remark-preset
-
-[github-preset-search]: https://github.com/topics/remark-preset
-
-[awesome]: https://github.com/remarkjs/awesome
-
-[ideas]: https://github.com/remarkjs/ideas
-
-[topic]: https://github.com/topics/remark-plugin
-
-[unified]: https://github.com/unifiedjs/unified
-
-[collective]: https://opencollective.com/unified
-
-[create]: #creating-plugins
+[discussions]: https://github.com/remarkjs/remark/discussions
 
-[d]: https://github.com/remarkjs/remark-directive
+[rehype-plugins]: https://github.com/rehypejs/rehype/blob/main/doc/plugins.md#list-of-plugins

package.json

@@ -10,31 +10,35 @@
     "url": "https://opencollective.com/unified"
   },
   "type": "module",
+  "workspaces": [
+    "packages/remark-parse",
+    "packages/remark-stringify",
+    "packages/remark",
+    "packages/remark-cli"
+  ],
   "devDependencies": {
     "@types/mdast": "^3.0.0",
     "@types/tape": "^4.0.0",
     "c8": "^7.0.0",
     "camelcase": "^6.0.0",
-    "execa": "^5.0.0",
-    "lerna": "^4.0.0",
+    "execa": "^6.0.0",
     "mdast-util-assert": "^4.0.0",
-    "mdast-util-gfm": "^1.0.0",
-    "micromark-extension-gfm": "^1.0.0",
+    "mdast-util-gfm": "^2.0.0",
+    "micromark-extension-gfm": "^2.0.0",
     "prettier": "^2.0.0",
-    "remark-preset-wooorm": "^8.0.0",
+    "remark-preset-wooorm": "^9.0.0",
     "rimraf": "^3.0.0",
     "tape": "^5.0.0",
     "type-coverage": "^2.0.0",
     "typescript": "^4.0.0",
     "unified": "^10.0.0",
     "unist-util-remove-position": "^4.0.0",
-    "xo": "^0.43.0"
+    "xo": "^0.46.0"
   },
   "scripts": {
-    "postinstall": "lerna bootstrap --no-ci",
-    "build": "lerna run build && rimraf \"*.d.ts\" \"{test,script}/**/*.d.ts\" && tsc && type-coverage",
+    "build": "npm run build --workspaces && rimraf \"*.d.ts\" \"{test,script}/**/*.d.ts\" && tsc && type-coverage",
     "format": "./packages/remark-cli/cli.js . -qfo && prettier . -w --loglevel warn && xo --fix",
-    "test-api": "lerna run test && node --conditions development test/index.js",
+    "test-api": "npm run test --workspaces && node --conditions development test/index.js",
     "test-coverage": "c8 --check-coverage --branches 100 --functions 100 --lines 100 --statements 100 --reporter lcov npm run test-api",
     "test": "npm run build && npm run format && npm run test-coverage"
   },

packages/remark-cli/cli.js

@@ -21,7 +21,6 @@ const extensions = [
 ]
 
 args({
-  // @ts-expect-error: fine.
   processor: remark,
   name: proc.name,
   description: cli.description,
@@ -30,7 +29,6 @@ args({
     cli.name + ': ' + cli.version
   ].join(', '),
   pluginPrefix: proc.name,
-  presetPrefix: proc.name + '-preset',
   packageField: proc.name + 'Config',
   rcName: '.' + proc.name + 'rc',
   ignoreName: '.' + proc.name + 'ignore',

packages/remark-cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "remark-cli",
   "version": "10.0.0",
-  "description": "CLI to process markdown with remark",
+  "description": "Command line interface to inspect and change markdown files with remark",
   "license": "MIT",
   "keywords": [
     "unified",

packages/remark-cli/test.js

@@ -1,5 +1,5 @@
 import {URL, fileURLToPath} from 'node:url'
-import execa from 'execa'
+import {execa} from 'execa'
 import test from 'tape'
 
 test('remark-cli', (t) => {
@@ -16,7 +16,7 @@ test('remark-cli', (t) => {
         [
           'Usage: remark [options] [path | glob ...]',
           '',
-          '  CLI to process markdown with remark',
+          '  Command line interface to inspect and change markdown files with remark',
           '',
           'Options:',
           '',

packages/remark-parse/package.json

@@ -1,7 +1,7 @@
 {
   "name": "remark-parse",
-  "version": "10.0.0",
-  "description": "remark plugin to parse markdown",
+  "version": "10.0.1",
+  "description": "remark plugin to add support for parsing markdown input",
   "license": "MIT",
   "keywords": [
     "unified",

packages/remark-parse/test.js

@@ -15,7 +15,7 @@ test('remarkParse', (t) => {
   t.test('extensions', (t) => {
     const tree = unified()
       .data('micromarkExtensions', [gfm()])
-      .data('fromMarkdownExtensions', [gfmFromMarkdown])
+      .data('fromMarkdownExtensions', [gfmFromMarkdown()])
       .use(remarkParse)
       .parse('* [x] contact@example.com ~~strikethrough~~')
 

packages/remark-stringify/lib/index.js

@@ -1,6 +1,7 @@
 /**
  * @typedef {import('mdast').Root|import('mdast').Content} Node
- * @typedef {import('mdast-util-to-markdown').Options} Options
+ * @typedef {import('mdast-util-to-markdown').Options} ToMarkdownOptions
+ * @typedef {Omit<ToMarkdownOptions, 'extensions'>} Options
  */
 
 import {toMarkdown} from 'mdast-util-to-markdown'
@@ -18,7 +19,10 @@ export default function remarkStringify(options) {
         // Note: this option is not in the readme.
         // The goal is for it to be set by plugins on `data` instead of being
         // passed by users.
-        extensions: this.data('toMarkdownExtensions') || []
+        extensions:
+          /** @type {ToMarkdownOptions['extensions']} */ (
+            this.data('toMarkdownExtensions')
+          ) || []
       })
     )
   }

packages/remark-stringify/package.json

@@ -1,7 +1,7 @@
 {
   "name": "remark-stringify",
-  "version": "10.0.0",
-  "description": "remark plugin to compile markdown",
+  "version": "10.0.2",
+  "description": "remark plugin to add support for serializing markdown",
   "license": "MIT",
   "keywords": [
     "unified",

packages/remark-stringify/test.js

@@ -429,7 +429,7 @@ test('stringify escapes', (t) => {
   t.equal(toString('![a'), '!\\[a\n', 'the `[` in `![`')
   t.equal(toString('a~b'), 'a~b\n', '`~`')
   t.equal(toString('a|b'), 'a|b\n', '`|`')
-  t.equal(toString('a_b'), 'a_b\n', '`_` (in words)')
+  t.equal(toString('a_b'), 'a\\_b\n', '`_` (in words)')
   t.equal(toString('a _b'), 'a \\_b\n', '`_` after `\\b`')
   t.equal(toString('a_ b'), 'a\\_ b\n', '`_` before `\\b`')
   t.equal(toString('a:b'), 'a:b\n', '`:`')
@@ -445,19 +445,19 @@ test('stringify escapes', (t) => {
   t.equal(toString('+a'), '\\+a\n', '`+` (phrasing)')
   t.equal(toString('.a'), '.a\n', '`.`')
   t.equal(toString('1.a'), '1.a\n', '`.` (after digit before letter)')
-  t.equal(toString('1. '), '1\\. \n', '`.` (after digit, with space)')
-  t.equal(toString('1.\t'), '1\\.\t\n', '`.` (after digit, with tab)')
+  t.equal(toString('1. '), '1\\. \n', '`.` (after digit, with space)')
+  t.equal(toString('1.\t'), '1\\.	\n', '`.` (after digit, with tab)')
   t.equal(toString('1.\n'), '1\\.\n', '`.` (after digit, with newline)')
   t.equal(toString('1.'), '1\\.\n', '`.` (after digit, with EOF)')
   t.equal(toString('1.a'), '1.a\n', '`1.` (after digit, before letter)')
-  t.equal(toString('1. '), '1\\. \n', '`1.` (after digit, with space)')
-  t.equal(toString('1.\t'), '1\\.\t\n', '`1.` (after digit, with tab)')
+  t.equal(toString('1. '), '1\\. \n', '`1.` (after digit, with space)')
+  t.equal(toString('1.\t'), '1\\.	\n', '`1.` (after digit, with tab)')
   t.equal(toString('1.\n'), '1\\.\n', '`1.` (after digit, with newline)')
   t.equal(toString('1.'), '1\\.\n', '`1.` (after digit, with EOF)')
   t.equal(toString(')a'), ')a\n', '`)`')
   t.equal(toString('1)a'), '1\\)a\n', '`)` (after digit)')
-  t.equal(toString('1) '), '1\\) \n', '`)` (after digit, with space)')
-  t.equal(toString('1)\t'), '1\\)\t\n', '`)` (after digit, with tab)')
+  t.equal(toString('1) '), '1\\) \n', '`)` (after digit, with space)')
+  t.equal(toString('1)\t'), '1\\)	\n', '`)` (after digit, with tab)')
   t.equal(toString('1)\n'), '1\\)\n', '`)` (after digit, with newline)')
   t.equal(toString('1)'), '1\\)\n', '`)` (after digit, with EOL)')
   t.equal(toString('a](b'), 'a]\\(b\n', '`(` after `]`')

packages/remark/package.json

@@ -1,7 +1,7 @@
 {
   "name": "remark",
-  "version": "14.0.1",
-  "description": "Markdown processor powered by plugins part of the unified collective",
+  "version": "14.0.2",
+  "description": "unified processor with support for parsing markdown input and serializing markdown as output",
   "license": "MIT",
   "keywords": [
     "unified",

test/fixtures/tree/amps-and-angles-encoding.json

@@ -217,8 +217,8 @@
               "offset": 125
             }
           },
-          "identifier": "1",
           "label": "1",
+          "identifier": "1",
           "referenceType": "shortcut"
         },
         {
@@ -302,8 +302,8 @@
               "offset": 216
             }
           },
-          "identifier": "2",
           "label": "2",
+          "identifier": "2",
           "referenceType": "shortcut"
         },
         {

test/fixtures/tree/case-insensitive-refs.json

@@ -36,8 +36,8 @@
               "offset": 4
             }
           },
-          "identifier": "hi",
           "label": "hi",
+          "identifier": "hi",
           "referenceType": "shortcut"
         }
       ],

test/fixtures/tree/definition-in-list-and-blockquote.json

@@ -36,8 +36,8 @@
               "offset": 10
             }
           },
-          "identifier": "1",
           "label": "1",
+          "identifier": "1",
           "referenceType": "full"
         },
         {
@@ -88,8 +88,8 @@
               "offset": 22
             }
           },
-          "identifier": "2",
           "label": "2",
+          "identifier": "2",
           "referenceType": "full"
         },
         {

test/fixtures/tree/definition-newline.json

@@ -150,8 +150,8 @@
               "offset": 124
             }
           },
-          "identifier": "baz",
           "label": "baz",
+          "identifier": "baz",
           "referenceType": "shortcut"
         },
         {

test/fixtures/tree/links-reference-proto.json

@@ -52,8 +52,8 @@
               "offset": 21
             }
           },
-          "identifier": "tostring",
           "label": "toString",
+          "identifier": "tostring",
           "referenceType": "full"
         },
         {
@@ -104,8 +104,8 @@
               "offset": 47
             }
           },
-          "identifier": "constructor",
           "label": "constructor",
+          "identifier": "constructor",
           "referenceType": "full"
         },
         {
@@ -156,8 +156,8 @@
               "offset": 74
             }
           },
-          "identifier": "__proto__",
           "label": "__proto__",
+          "identifier": "__proto__",
           "referenceType": "full"
         },
         {

test/fixtures/tree/links-reference-style.json → test/fixtures/tree/links-reference-style.nooutput.json

@@ -52,8 +52,8 @@
               "offset": 13
             }
           },
-          "identifier": "1",
           "label": "1",
+          "identifier": "1",
           "referenceType": "shortcut"
         },
         {
@@ -137,8 +137,8 @@
               "offset": 28
             }
           },
-          "identifier": "1",
           "label": "1",
+          "identifier": "1",
           "referenceType": "full"
         },
         {
@@ -222,8 +222,8 @@
               "offset": 44
             }
           },
-          "identifier": "1",
           "label": "1",
+          "identifier": "1",
           "referenceType": "shortcut"
         },
         {
@@ -326,8 +326,8 @@
               "offset": 101
             }
           },
-          "identifier": "b",
           "label": "b",
+          "identifier": "b",
           "referenceType": "shortcut"
         },
         {
@@ -411,8 +411,8 @@
               "offset": 122
             }
           },
-          "identifier": "once",
           "label": "once",
+          "identifier": "once",
           "referenceType": "collapsed"
         },
         {
@@ -496,8 +496,8 @@
               "offset": 143
             }
           },
-          "identifier": "twice",
           "label": "twice",
+          "identifier": "twice",
           "referenceType": "collapsed"
         },
         {
@@ -581,8 +581,8 @@
               "offset": 165
             }
           },
-          "identifier": "thrice",
           "label": "thrice",
+          "identifier": "thrice",
           "referenceType": "collapsed"
         },
         {
@@ -792,8 +792,8 @@
               "offset": 289
             }
           },
-          "identifier": "this",
           "label": "this",
+          "identifier": "this",
           "referenceType": "shortcut"
         },
         {
@@ -844,8 +844,8 @@
               "offset": 296
             }
           },
-          "identifier": "this",
           "label": "this",
+          "identifier": "this",
           "referenceType": "shortcut"
         },
         {
@@ -929,8 +929,8 @@
               "offset": 332
             }
           },
-          "identifier": "this",
           "label": "this",
+          "identifier": "this",
           "referenceType": "full"
         },
         {
@@ -1014,8 +1014,8 @@
               "offset": 345
             }
           },
-          "identifier": "this",
           "label": "this",
+          "identifier": "this",
           "referenceType": "shortcut"
         },
         {
@@ -1099,8 +1099,8 @@
               "offset": 363
             }
           },
-          "identifier": "this",
           "label": "this",
+          "identifier": "this",
           "referenceType": "collapsed"
         },
         {
@@ -1184,8 +1184,8 @@
               "offset": 376
             }
           },
-          "identifier": "this",
           "label": "this",
+          "identifier": "this",
           "referenceType": "shortcut"
         },
         {
@@ -1368,8 +1368,8 @@
               "offset": 463
             }
           },
-          "identifier": "this",
           "label": "this",
+          "identifier": "this",
           "referenceType": "collapsed"
         },
         {
@@ -1453,8 +1453,8 @@
               "offset": 495
             }
           },
-          "identifier": "this",
           "label": "this",
+          "identifier": "this",
           "referenceType": "shortcut"
         },
         {
@@ -1689,8 +1689,8 @@
               "offset": 670
             }
           },
-          "identifier": "link breaks",
           "label": "link\nbreaks",
+          "identifier": "link breaks",
           "referenceType": "shortcut"
         },
         {
@@ -1774,8 +1774,8 @@
               "offset": 725
             }
           },
+          "label": "link \nbreaks",
           "identifier": "link breaks",
-          "label": "link\nbreaks",
           "referenceType": "shortcut"
         },
         {

test/fixtures/tree/links-shortcut-references.json → test/fixtures/tree/links-shortcut-references.nooutput.json

@@ -52,8 +52,8 @@
               "offset": 25
             }
           },
-          "identifier": "simple case",
           "label": "simple case",
+          "identifier": "simple case",
           "referenceType": "shortcut"
         },
         {
@@ -156,8 +156,8 @@
               "offset": 81
             }
           },
-          "identifier": "line break",
           "label": "line\nbreak",
+          "identifier": "line break",
           "referenceType": "shortcut"
         },
         {
@@ -241,8 +241,8 @@
               "offset": 112
             }
           },
+          "label": "line \nbreak",
           "identifier": "line break",
-          "label": "line\nbreak",
           "referenceType": "shortcut"
         },
         {
@@ -329,8 +329,8 @@
               "offset": 167
             }
           },
-          "identifier": "this",
           "label": "this",
+          "identifier": "this",
           "referenceType": "shortcut"
         },
         {
@@ -381,8 +381,8 @@
               "offset": 174
             }
           },
-          "identifier": "that",
           "label": "that",
+          "identifier": "that",
           "referenceType": "shortcut"
         },
         {
@@ -433,8 +433,8 @@
               "offset": 190
             }
           },
-          "identifier": "other",
           "label": "other",
+          "identifier": "other",
           "referenceType": "shortcut"
         }
       ],

test/fixtures/tree/main.json

@@ -105,8 +105,8 @@
               "offset": 237
             }
           },
-          "identifier": "test",
           "label": "test",
+          "identifier": "test",
           "referenceType": "full"
         },
         {

test/fixtures/tree/markdown-documentation-basics.json

@@ -136,8 +136,8 @@
               "offset": 700
             }
           },
-          "identifier": "s",
           "label": "s",
+          "identifier": "s",
           "referenceType": "shortcut"
         },
         {
@@ -221,8 +221,8 @@
               "offset": 1050
             }
           },
-          "identifier": "d",
           "label": "d",
+          "identifier": "d",
           "referenceType": "shortcut"
         },
         {
@@ -339,8 +339,8 @@
               "offset": 1278
             }
           },
-          "identifier": "src",
           "label": "src",
+          "identifier": "src",
           "referenceType": "shortcut"
         },
         {

test/fixtures/tree/markdown-documentation-syntax.json

@@ -1584,8 +1584,8 @@
               "offset": 1232
             }
           },
-          "identifier": "src",
           "label": "src",
+          "identifier": "src",
           "referenceType": "full"
         },
         {
@@ -1768,8 +1768,8 @@
               "offset": 1746
             }
           },
-          "identifier": "1",
           "label": "1",
+          "identifier": "1",
           "referenceType": "shortcut"
         },
         {
@@ -1820,8 +1820,8 @@
               "offset": 1757
             }
           },
-          "identifier": "2",
           "label": "2",
+          "identifier": "2",
           "referenceType": "shortcut"
         },
         {
@@ -1872,8 +1872,8 @@
               "offset": 1772
             }
           },
-          "identifier": "3",
           "label": "3",
+          "identifier": "3",
           "referenceType": "shortcut"
         },
         {
@@ -1924,8 +1924,8 @@
               "offset": 1796
             }
           },
-          "identifier": "4",
           "label": "4",
+          "identifier": "4",
           "referenceType": "shortcut"
         },
         {
@@ -1976,8 +1976,8 @@
               "offset": 1813
             }
           },
-          "identifier": "5",
           "label": "5",
+          "identifier": "5",
           "referenceType": "shortcut"
         },
         {
@@ -2028,8 +2028,8 @@
               "offset": 1831
             }
           },
-          "identifier": "6",
           "label": "6",
+          "identifier": "6",
           "referenceType": "shortcut"
         },
         {
@@ -4371,8 +4371,8 @@
               "offset": 7417
             }
           },
-          "identifier": "bq",
           "label": "bq",
+          "identifier": "bq",
           "referenceType": "full"
         },
         {
@@ -4423,8 +4423,8 @@
               "offset": 7453
             }
           },
-          "identifier": "l",
           "label": "l",
+          "identifier": "l",
           "referenceType": "full"
         },
         {
@@ -4562,8 +4562,8 @@
               "offset": 7646
             }
           },
-          "identifier": "1",
           "label": "1",
+          "identifier": "1",
           "referenceType": "shortcut"
         },
         {
@@ -4614,8 +4614,8 @@
               "offset": 7660
             }
           },
-          "identifier": "2",
           "label": "2",
+          "identifier": "2",
           "referenceType": "shortcut"
         },
         {

test/fixtures/tree/nested-references.json

@@ -55,8 +55,8 @@
                   "offset": 44
                 }
               },
-              "identifier": "bar",
               "label": "bar",
+              "identifier": "bar",
               "referenceType": "full"
             }
           ],
@@ -72,8 +72,8 @@
               "offset": 50
             }
           },
-          "identifier": "baz",
           "label": "baz",
+          "identifier": "baz",
           "referenceType": "full"
         }
       ],
@@ -174,8 +174,8 @@
               "offset": 98
             }
           },
-          "identifier": "bar",
           "label": "bar",
+          "identifier": "bar",
           "referenceType": "full"
         },
         {
@@ -226,8 +226,8 @@
               "offset": 104
             }
           },
-          "identifier": "baz",
           "label": "baz",
+          "identifier": "baz",
           "referenceType": "shortcut"
         }
       ],

test/fixtures/tree/ref-paren.json

@@ -36,8 +36,8 @@
               "offset": 4
             }
           },
-          "identifier": "hi",
           "label": "hi",
+          "identifier": "hi",
           "referenceType": "shortcut"
         }
       ],

test/fixtures/tree/reference-image-empty-alt.json

@@ -19,8 +19,8 @@
               "offset": 6
             }
           },
-          "identifier": "1",
           "label": "1",
+          "identifier": "1",
           "referenceType": "full"
         }
       ],

test/fixtures/tree/reference-link-escape.nooutput.json

@@ -36,8 +36,8 @@
               "offset": 10
             }
           },
-          "identifier": "b\\*r*",
           "label": "b*r*",
+          "identifier": "b\\*r*",
           "referenceType": "full"
         },
         {
@@ -88,8 +88,8 @@
               "offset": 21
             }
           },
-          "identifier": "b\\*r*",
           "label": "b*r*",
+          "identifier": "b\\*r*",
           "referenceType": "collapsed"
         },
         {
@@ -140,8 +140,8 @@
               "offset": 30
             }
           },
-          "identifier": "b\\*r*",
           "label": "b*r*",
+          "identifier": "b\\*r*",
           "referenceType": "shortcut"
         },
         {
@@ -192,8 +192,8 @@
               "offset": 46
             }
           },
-          "identifier": "b\\*r*",
           "label": "b*r*",
+          "identifier": "b\\*r*",
           "referenceType": "full"
         },
         {
@@ -227,8 +227,8 @@
               "offset": 58
             }
           },
-          "identifier": "b\\*r*",
           "label": "b*r*",
+          "identifier": "b\\*r*",
           "referenceType": "collapsed"
         },
         {
@@ -262,8 +262,8 @@
               "offset": 68
             }
           },
-          "identifier": "b\\*r*",
           "label": "b*r*",
+          "identifier": "b\\*r*",
           "referenceType": "shortcut"
         },
         {

test/fixtures/tree/reference-link-with-angle-brackets.json

@@ -36,8 +36,8 @@
               "offset": 5
             }
           },
-          "identifier": "foo",
           "label": "foo",
+          "identifier": "foo",
           "referenceType": "shortcut"
         }
       ],

test/fixtures/tree/reference-link-with-multiple-definitions.json

@@ -36,8 +36,8 @@
               "offset": 5
             }
           },
-          "identifier": "foo",
           "label": "foo",
+          "identifier": "foo",
           "referenceType": "shortcut"
         }
       ],