@x-govuk/govuk-eleventy-plugin/src/markdown-it.js

Write documentation using Markdown and publish it using GOV.UK styles

import slugify from '@sindresorhus/slugify'
import MarkdownIt from 'markdown-it'
import markdownItAbbr from 'markdown-it-abbr'
import markdownItAnchor from 'markdown-it-anchor'
import markdownItDeflist from 'markdown-it-deflist'
import markdownItFootnote from 'markdown-it-footnote'
import markdownItGovuk from 'markdown-it-govuk'
import highlight from 'markdown-it-govuk/highlight'
import markdownItImageFigures from 'markdown-it-image-figures'
import markdownItIns from 'markdown-it-ins'
import markdownItMark from 'markdown-it-mark'
import markdownItSub from 'markdown-it-sub'
import markdownItSup from 'markdown-it-sup'
import markdownItTableOfContents from 'markdown-it-table-of-contents'

import { defListRules } from './markdown-it/deflist.js'
import { footnotesRules } from './markdown-it/footnote.js'
import { tableOfContentsRules } from './markdown-it/table-of-contents.js'
import { tableRules } from './markdown-it/table.js'

/**
 * Configure markdown-it
 *
 * @see {@link https://markdown-it.github.io/markdown-it/}
 * @param {object} [options] - Plugin options
 * @returns {Function} markdown-it instance
 */
export function md(options = {}) {
  const opts = {
    breaks: true,
    highlight,
    html: true,
    linkify: false,
    typographer: true
  }

  const md = new MarkdownIt(opts)
    .use(markdownItGovuk, {
      headingsStartWith: 'xl',
      calvert: true
    })
    .use(markdownItAbbr)
    .use(markdownItAnchor, {
      permalink: options.headingPermalinks
        ? markdownItAnchor.permalink.headerLink({
            class: 'app-link--heading',
            safariReaderFix: true
          })
        : false,
      slugify: (string) => slugify(string).replaceAll(/[*+~.()'"!:@]/g, '')
    })
    .use(markdownItDeflist)
    .use(defListRules)
    .use(markdownItFootnote)
    .use(footnotesRules)
    .use(markdownItIns)
    .use(markdownItImageFigures, {
      figcaption: true
    })
    .use(markdownItMark)
    .use(markdownItSub)
    .use(markdownItSup)
    .use(tableRules)
    .use(markdownItTableOfContents, {
      includeLevel: [2, 3]
    })
    .use(tableOfContentsRules)

  return md
}