mdast-zone

MDAST utility to treat HTML comments as ranges. Useful in remark plugins.

Installation

npm:

npm install mdast-zone

Usage

Say we have the following file, example.md:

<!--foo start-->

Foo

<!--foo end-->

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

var vfile = require('to-vfile')
var remark = require('remark')
var zone = require('mdast-zone')

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) {
    zone(tree, 'foo', mutate)
  }

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

Now, running node example yields:

<!--foo start-->

Bar

<!--foo end-->

API

zone(tree, name, handler)

Search tree for comment ranges (“zones”).

Parameters

• tree (Node) — Node to search for ranges
• name (string) — Name of ranges to search for
• handler (Function) — Function invoked for each found range

function handler(start, nodes, end)

Invoked with the two markers that determine a range: the first start and the last end, and the content inside.

Parameters

• start (Node) — Start of range (an HTML comment node)
• nodes (Array.<Node>) — Nodes between start and end
• end (Node) — End of range (an HTML comment node)

Returns

Array.<Node>? — List of nodes to replace start, nodes, and end with, optional.

Contribute

See contributing.md in syntax-tree/mdast for ways to get started.

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

License

MIT © Titus Wormer