#BlackLivesMatter

unified

Project: manovotny/remark-excerpt

Package: remark-excerpt@1.0.0-beta.1

  1. Dependents: 0
  2. Remark transformer for extracting an excerpt.
  1. 53%
  2. MIT
  3. 7
  1. 916 B
  2. 102
  1. remark 214
  2. markdown 154
  3. remark-plugin 82
  4. excerpt 4

remark-excerpt

Remark transformer for extracting an excerpt.

This is a remark plugin for transformer for extracting an excerpt, similar to WordPress's excerpt functionality.

Installation

NPM

$ npm i remark-excerpt

Yarn

$ yarn add remark-excerpt

Usage

Say we have the following file, example.md:

# Title

Paragraph 1.

Paragraph 2.

<!-- excerpt -->

Paragraph 3.

Paragraph 4.

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

const remark = require('remark');
const excerpt = require('remark-excerpt');
const vfile = require('to-vfile');

(async () => {
    const file = await vfile.read('example.md');
    const result = await remark().use(excerpt).process(file);

    console.log(result.toString());
})();

Now, running node example yields:

# Title

Paragraph 1.

Paragraph 2.

You can try this yourself by downloading or cloning the project, installing dependencies, and running yarn example.

API

remark().use(excerpt[, options])

Returns markdown content specified before the excerpt comment.

Options

identifier

Type: String Default: excerpt, more, preview, or teaser

Specifies the excerpt comment identifier to look for.

License

MIT © Michael Novotny