unified

Project: shivjm/remark-extensions

Package: remark-kbd-nested@0.4.1

  1. remark plugin to add support for kbd element syntax with configurable delimiters, escaping, and arbitrary nesting
  1. 61%
  2. ISC
  3. 0
  1. 69
  1. remark 213
  2. markdown 152
  3. plugin 136
  4. kbd 2
  5. keyboard 2

remark-kbd-nested

Build Downloads Size

remark extension to support kbd element syntax with configurable delimiters, escaping, var sequences, and arbitrary nesting (e.g. Ctrl + key).

Docs at shivjm.github.io/remark-extensions.

Install

This package is ESM only: Node 18+ is needed to use it and it must be imported instead of required.

npm:

npm install micromark-extension-kbd-nested

Use

import { remark } from "remark";
import { remarkKbdNested } from "remark-kbd-nested";
import remarkRehype from "remark-rehype";
import rehypeStringify from "rehype-stringify";

const output = remark()
      .use(remarkKbdNested)
      .use(remarkRehype)
      .use(rehypeStringify)
      .processSync("Press ||| ||Ctrl|| + || \| || |||, then || //key// ||.");

console.log(String(output));

Yields:

<p>Press <kbd><kbd>Ctrl</kbd> + <kbd>|</kbd></kbd>, then <kbd><var>key</var></kbd>.</p>

Syntax

See micromark-extension-kbd-nested.

API

remarkKbdNested(options?)

Returns a remark plugin to parse keyboard sequences optionally containing variable sequences (can be passed to use). The options are passed directly to micromark-extension-kbd-nested.

License

ISC © Shiv Jha Mathur