markdown-it-bracketed-spans

July 22, 2026 ยท View on GitHub

Span tag plugin for markdown-it markdown parser.

Markup is based on pandoc bracketed_spans extension, for example:

paragraph with [a span]{.myClass}

Must be used together with the markdown-it-attrs plugin (that's a peer dependency).

Usage

import mdIt from 'markdown-it';
import mdItBracketedSpans from 'markdown-it-bracketed-spans';
import mdItAttrs from 'markdown-it-attrs';

const md = mdIt().use(mdItBracketedSpans).use(mdItAttrs);
const output = md.render('foo [bar *bar*]{#id .class attr=value} baz');

Output will be:

<p>
  foo
  <span id="id" class="class" attr="value">
    bar <em>bar</em>
  </span>
  baz
</p>