Runme.js

A JavaScript module to use Runme in Node.js, Deno or browser environments.

Runme.js contains the the Runme CLI as WASM and allows to access its functionality through a simple JavaScript interface.

Install

You can run this module in Node.js and Deno environments.

Node.js

Install the module through NPM:

$ npm install runme
# or Yarn
$ yarn add runme

You can also install the package globally and it as a CLI, e.g.:

npm i -g runme
runme list

Deno

You can import the module directly from the Deno module hosting service via https://deno.land/x/runme@0.4.1/mod.ts.

Usage

The module exposes the following methods:

parse

Parse markdown into AST:

import { parse } from 'runme'
// or when using Deno:
// import { parse } from 'https://deno.land/x/runme@0.4.1/mod.ts'

console.log(await parse(
    '## Hello World\n' +
    '```sh\n' +
    'echo "Hello World"\n'
    '```'
))
/**
 * outputs:
 * [{
 *     kind: 1,
 *     languageId: "",
 *     value: "# Hello World",
 * }, {
 *     kind: 2,
 *     languageId: "sh",
 *     metadata: {
 *       "runme.dev/name": "echo-hello",
 *     },
 *     value: 'echo "Hello World"',
 * }]
 */

Copyright 2022 © Stateful – Apache 2.0 License