GerHobbeltmarkdown-it-title 
Extract title during markdown-it parsing.
Overview
This plugin is useful if you want to write plain markdown files, e.g.
without YAML front matter, and want to extract the document title to
populate a HTML <title> tag, Open Graph and so on.
Additionally, markdown-it-title supports extracting the contents of the first paragraphs if you want to use them as meta description, post excerpt and so forth.
Usage
const opts = {
level: 1,
excerpt: 2
}
const md = require('markdown-it')()
.use(require('markdown-it-title'), opts)
// Find whatever heading comes first.
// md.use(require('markdown-it-title'), { level: 0 })
// Find `<h2>`.
// md.use(require('markdown-it-title'), { level: 2 })
const env = {}
md.render(`# [Hello](#hello), *world*!
This is the **first** paragraph.
## Hi, I'm a title
Another one.
And another one.
`, env)
env.title === 'Hello, world!'
env.excerpt[0] === 'This is the first paragraph.'
env.excerpt[1] === 'Another one.'
The opts object can contain:
| Name | Description | Default |
|---|---|---|
level |
Heading level to look for the title. Use 0 to take whichever heading comes first. | 1 |
excerpt |
Number of paragraphs to extract from the beginning of the document to be used as page excerpt. | 0 |
Setting level to 1 (the default) will extract the contents of the
first <h1> to env.title. If set to 0, markdown-it-title will take
the first heading it encounters.
Also, the first excerpt paragraphs will be extracted in the
env.excerpt array (not enabled by default).
Both title and excerpt text won't include any markup.