Package Exports

mdast-util-heading-range

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mdast-util-heading-range) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

mdast-util-heading-range

mdast utility to use headings as ranges.

Install

npm:

npm install mdast-util-heading-range

Usage

Say we have the following file, example.md:

# Foo

Bar.

# Baz

And our script, example.js, looks as follows:

var vfile = require('to-vfile')
var remark = require('remark')
var heading = require('mdast-util-heading-range')

remark()
  .use(plugin)
  .process(vfile.readSync('example.md'), function(err, file) {
    if (err) throw err
    console.log(String(file))
  })

function plugin() {
  return transform

  function transform(tree) {
    heading(tree, 'foo', mutate)
  }

  function mutate(start, nodes, end) {
    return [
      start,
      {type: 'paragraph', children: [{type: 'text', value: 'Qux.'}]},
      end
    ]
  }
}

Now, running node example yields:

# Foo

Qux.

# Baz

API

`heading(tree, test|options, onrun)`

Search tree (Node) and transform a section without affecting other parts with onrun (Function). A “section” is a heading that passes test, until the next heading of the same or lower depth, or the end of the document. If ignoreFinalDefinitions: true, final definitions “in” the section are excluded.

`options`

`options.test`

Heading to look for (string, RegExp, Function). When string, wrapped in new RegExp('^(' + value + ')$', 'i'); when RegExp, wrapped in function (value) {expression.test(value)}

`options.ignoreFinalDefinitions`

Ignore final definitions otherwise in the section (boolean, default: false).

`function test(value, node)`

Function invoked for each heading with its content (string) and node itself (Heading) to check if it’s the one to look for.

Returns

Boolean?, true if this is the heading to use.

`function onrun(start, nodes, end?, scope)`

Callback invoked when a range is found.

Parameters

`start`

Start of range (Heading).

`nodes`

Nodes between start and end (Array.<Node>).

`end`

End of range, if any (Node?).

`scope`

Extra info (Object):

parent (Node) — Parent of the range
start (number) — Index of start in parent
end (number?) — Index of end in parent

Contribute

See contributing.md in syntax-tree/.github for ways to get started. See support.md for ways to get help.

This project has a Code of Conduct. By interacting with this repository, organisation, or community you agree to abide by its terms.