mkast

Abstract syntax tree transformer

Usage no npm install needed!

<script type="module">
  import mkast from 'https://cdn.skypack.dev/mkast';
</script>

README

Tree

Build Status npm version Coverage Status

Converts nodes to and from JSON

Transforms commonmark nodes to and from JSON for piping between processes.

Install

npm i mkast


Usage

Serialize commonmark nodes to line-delimited JSON:

var mkast = require('mkast')
  , ast = mkast.parse('# Title\n<? @include file.md ?>');
mkast.serialize(ast).pipe(process.stdout);

For more information see the api docs.

API

parser

parser(stream[, cb])

Parse line-delimited JSON to vanilla objects.

When a callback function is given it is added as a listener for the error and finish events on the parser stream.

Returns the parser stream.

  • stream Object input stream.
  • cb Function callback function.

deserialize

deserialize([stream][, cb])

Deserialize line-delimited JSON to commonmark nodes.

When a callback function is given it is added as a listener for the error and eof events on the deserializer stream.

The eof event can fire multiple times so the callback may be called multiple times.

Returns the deserializer stream.

  • stream Object input stream.
  • cb Function callback function.

serialize

serialize(node[, opts][, cb])

Serialize a commonmark AST node to line-delimited JSON.

When the node is of the document type it's direct descendants are detached from the document and streamed as independent lines. So that consumers of the stream will know when the document ends a node with an eof type is sent to indicate the end of file (EOF).

When injecting documents into a stream it may be desirable to disable this behaviour, to do so use:

{eof: false}

When a callback function is given it is added as a listener for the error and finish events on the serializer stream.

Returns the serializer stream.

  • node Object input AST node.
  • opts Object processing options.
  • cb Function callback function.

License

MIT


Created by mkdoc on April 2, 2016