remark-heading-autoid

0.1.1 • Public • Published

remark-heading-autoid

remark plugin to add numbered auto ids to headings:

<h2 id="id1">head</h2>

The plugin also supports custom ids:

## My Heading {#custom-id}

Will output to:

<h2 id="custom-id">My Heading</h2>

Install

npm install remark-heading-autoid

Options

You can pass a custom prefix for ids in options. If no prefix is provided, id, followed by the consecutive number of the heading, is used.

Use with Gatsby and MDX

In gatsby-congis.js:

const autoHeading = require('remark-heading-autoid')
module.exports = {
  plugins: [
    {
      resolve: `gatsby-plugin-mdx`,
      options: {
        remarkPlugins: [autoHeading, otherPlugin]
      }
    }
  ]
}

Use with options:

const autoHeading = require('remark-heading-autoid')
module.exports = {
  plugins: [
    {
      resolve: `gatsby-plugin-mdx`,
      options: {
        remarkPlugins: [[autoHeading, { prefix: 'heading-'}], otherPlugin]
      }
    }
  ]
}

Readme

Keywords

Package Sidebar

Install

npm i remark-heading-autoid

Weekly Downloads

8

Version

0.1.1

License

MIT

Unpacked Size

5.54 kB

Total Files

5

Last publish

Collaborators

  • iloveip