markdown-it-terminal

This is a plugin to provide ansi terminal output for markdown-it. It is heavily inspired by marked-terminal, a terminal renderer for the marked library.

This library is not officially supported by markdown-it.

This forked release adds #13 to upstream v0.1.1.

Install

npm install markdown-it markdown-it-terminal

Usage

markdown-it provides a method for extending it with plugins.

1var markdown = require('markdown-it');
2var terminal = require('markdown-it-terminal');
3
4markdown.use(terminal);

You can override the default options if you choose.

1var styles   = require('ansi-styles');
2var markdown = require('markdown-it');
3var terminal = require('markdown-it-terminal');
4
5var options = {
6  styleOptions: {
7    code: styles.green
8  }
9}
10markdown.use(terminal, options);
11// inline code now prints in green instead of the default yellow

Options

markdown-it-terminal takes several options, most of which are to override existing defaults.

1var options = {
2  styleOptions:{},
3  highlight: require('cardinal').highlight,
4  unescape: true,
5  indent: '  '
6}

styleOptions

Styles are defined per token, and make use of the ansi-styles library, which provides a number of open and close values for ansi codes.

In the most basic implementation, you can simply provide a supported style like so:

1var styles   = require('ansi-styles');
2
3var options = {
4  styleOptions: {
5    code: styles.green
6  }
7}

markdown-it-terminal exposes a utility method to build compound styles, using an array of style names (must be supported by ansi-styles).

1var styles   = require('ansi-styles');
2var terminal = require('markdown-it-terminal');
3
4var options = {
5  styleOptions: {
6    code: terminal.compoundStyle(['green','underline'])
7  }
8}

The following tokens can be overridden through styleOptions:

• code
• blockquote
• html
• heading
• firstHeading
• hr
• listitem
• table
• paragraph
• strong
• em
• codespan
• del
• link
• href

highlight

Highlight function to parse code blocks. Should be a function that takes a string and outputs a formatted string.

unescape

Unescape content, true by default.

indent

Indent all content under a heading (h1..h6) using this string. With indent: ' ' (two spaces):

# Heading 1
## Heading 2
Some stuff indented twice
#
Only indented once

Heading 1
  Heading 2
    Some stuff indented twice

  Only indented once

Highlighting

markdown-it-terminal uses the cardinal library for code highlight support by default.

Windows Support

Because ansi is not supported on cmd.exe, markdown-it-terminal only works on Windows shells with ansi support.