Skip to content

Remark transformer for extracting an excerpt.

License

Notifications You must be signed in to change notification settings

manovotny/remark-excerpt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

4e683ed · Nov 5, 2022

History

15 Commits
Nov 5, 2022
Feb 17, 2019
Nov 5, 2022
Nov 5, 2022
Feb 17, 2019
Feb 17, 2019
Nov 5, 2022
Feb 17, 2019
Feb 17, 2019
Feb 17, 2019
Nov 5, 2022
Nov 5, 2022
Nov 5, 2022
Nov 5, 2022
Nov 5, 2022
Nov 5, 2022
Nov 5, 2022
Nov 5, 2022
Nov 5, 2022
Nov 5, 2022

Repository files navigation

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