mdast-util-heading-range

mdast-util-heading-range

Markdown heading as ranges in mdast.

Installation

npm:

npm install mdast-util-heading-range

mdast-util-heading-range is also available for duo, and as an AMD, CommonJS, and globals module, uncompressed and compressed.

Usage

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

Process a document.

var doc = remark()
    .use(function () {
        return function (node) {
            heading(node, 'foo', function (start, nodes, end) {
                return [
                    start,
                    {
                        'type': 'paragraph',
                        'children': [
                            {
                                'type': 'text',
                                'value': 'Qux.'
                            }
                        ]
                    },
                    end
                ];
            });
        }
    }).process([
        '# Foo',
        '',
        'Bar.',
        '',
        '# Baz',
        ''
    ].join('\n'));

Yields:

# Foo

Qux.

# Baz

API

heading(node, test, onrun)

Transform part of a document without affecting other parts, by changing a section: a heading which passes test, until the next heading of the same or lower depth, or the end of the document.

Parameters

• node (Node) — Node to search;

• test (string, RegExp, function(string, Node): boolean) — Heading to look for:

  • When string, wrapped in new RegExp('^(' + value + ')$', 'i');

  • Then, when RegExp, wrapped in function (value) {expression.test(value)}.

• onrun (Array.<Node>? = function (start, nodes, end)) — Callback invoked when a range is found.

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

Parameters

• start (Heading) — Start of range;

• nodes (Array.<Node>) — Nodes between start and end;

• end (Heading?) — End of range, if any.

• scope (Object):

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

Returns

Array.<Node>? — Zero or more nodes to replace the range (including start, and end) with.

License

MIT © Titus Wormer