node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



A Metalsmith plugin to extract/generate an excerpt from file content or metadata with multiple options.

npm Package Version MIT License Dependencies Status devDependencies Status Travis Build Status Code Climate GPA Code Climate Test Coverage


metalsmith-better-excerpts will generate an excerpt for each file object either from frontmatter/metadata, from content until the first more tag or from the first paragraph in content. So generated excerpt content can be additionally parsed by underscore.string's stripTags and prune functions, although prune can only be used together with stripTags.


$ npm install metalsmith-better-excerpts

CLI Usage

Install via npm and then add the metalsmith-better-excerpts key to your metalsmith.json with any options you want, like so:

  "plugins": {
    "metalsmith-better-excerpts": {
      "pruneLength": 80

Javascript Usage

Pass options to the plugin and pass it to Metalsmith with the use method:

var excerpts = require('metalsmith-better-excerpts');
    pruneLength: 80


All options are optional...


var defaultOptions = {
        moreRegExp: /\s*<!--\s*more\s*-->/i,
        stripTags: true,
        pruneLength: 140,
        pruneString: ''