metalsmith-title

A Metalsmith plugin that automatically add page title from first heading in processed file

Additionally has the option to remove title from document after detecting it and setting it as metadata. Useful when you want to use markdown documents verbatim, but have special treatments for titles in your templates, such as putting them inside of tags.

Installation

Using npm

  npm install metalsmith-title

Using yarn

  yarn add metalsmith-title

Usage

Extract the first tile from all (HTML and Markdown) files.

  const title = require('metalsmith-title');
  metalsmith.use(title());

Use the title in a metalsmith-layouts

	<title>{{ title }}</title>

The title can be removed from the file after extraction.

  const title = require('metalsmith-title');
  metalsmith.use(title({ remove: true }));

CLI Usage

Install via npm and then add the metalsmith-title key to your metalsmith.json

  {
    "plugins": {
      "metalsmith-title": true
    }
  }

License

MIT