markdown-it-ignore v0.1.0

markdown-it-ignore

Ignore plugin for markdown-it markdown parser.

Installation

npm i markdown-it-ignore

Configuration

var md = require('markdown-it')();
var mii = require('markdown-it-ignore');
md.use(mii [, options]);

Options:

• secure (type: boolean, default: true): Secure HTML output

Differences in browser. If you load the script directly into the page without using a package system, the module will add itself globally with the name markdownitIgnore. Init code will look a bit different in this case:

var md = window.markdownit().use(window.markdownitIgnore);

Usage

Default

In your markdown you can use ::: as block separator to not parse what is inside.

It is similar to the fence block, but no <pre> nor <code> tags are added.

Example:

*This will be parsed*

:::
*This won't be parsed*
:::

Output:

<p><strong>This will be parsed</strong></p>
*This won't be parsed*

Unsecure

If you want to insert HTML inside the ignore block, set the secure option to false (else HTML characters are escaped).

Example:

:::
<div>This will preserved as is</div>
:::

Output:

<div>This will preserved as is</div>