Skip to content
A Metalsmith plugin to store the content before <!--more--> in HTML files.
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.


A Metalsmith plugin to store the content before <!--more--> in HTML files, akin to WordPress' More tag.

This plugin processes HTML files and adds a less key with the part of contents preceding the <!--more--> tag. The file extension to filter by, tag to truncate on, and key to store content in are customizable; see Options below.


$ npm install metalsmith-more

CLI Usage

Add the metalsmith-more key to your metalsmith.json file:

	"plugins": {
		"metalsmith-more": true

JavaScript Usage

var more = require('metalsmith-more');


metalsmith-more can be used with zero configuration, but it also supports the following options to customize its behavior:

  • ext - Extension to match against when examining files to operate on; default is html
  • regexp - Regular expression to truncate against; default is /\s*<!--\s*more\s*-->/. May also be specified as a string, which a RegExp will be constructed from.
  • key - Key to store truncated content in; default is less
  • alwaysAddKey - whether to always add the specified key even if a file contains no match to regexp; default is false.
    • When false, any file with no match will not contain the specified key.
    • When true, any file with no match will have the specified key's value set equal to the file's contents.

These options can be specified in an object passed to the plugin function or assigned to the metalsmith-more key in metalsmith.json.



You can’t perform that action at this time.