Front matter on markdown files

[robsonsobral]

Hi! Is it possible to parse the YAML front matter on markdown files to get title property? Or, at least, to ignore them completelly?

Thank you.

[mirisuzanne]

I like this idea. From there we could consider what other metadata might be useful. Seems like it should be straight-forward with something like gray-matter, but I'm not sure how MD files are loaded. @jgerigmeyer?

[jgerigmeyer]

Seems like it should be straight-forward with something like gray-matter, but I'm not sure how MD files are loaded. @jgerigmeyer?

@mirisuzanne Sure, I think that makes sense. We're currently using markdown-it for markdown parsing. We could try markdown-it-front-matter, but it actually looks to me like running through gray-matter before markdown-it would be simpler.

I think the first question is how we want to expose this option to users.

[robsonsobral]

I've several files using front matter here. I guess, the only metadata useful would be:

• title
• slug
• lang
• description

As an example, this is the front matter of a file I'm using on a project (I parse using pandoc).

---
title: "Content modelling"
subtitle: "Lorem ipsum"
author:
- foobar
description: |
    Lorem ipsum
toc: true
toc-title: FOO
titlepage: true
toc-own-page: true
footnotes-pretty: true
date: "2021-06-07"
lang: pt-BR
### gerar PDF: pandoc --template eisvogel -f markdown --pdf-engine=xelatex --mathjax --filter mermaid-filter.cmd content-modelling.md -o content-modelling.pdf
## gerar DOCX: pandoc --template rmd-minion-reference -f markdown --pdf-engine=xelatex --mathjax --filter mermaid-filter.cmd content-modelling.md -o content-modelling.docx
---

If I submit the same file to Herman, just 3 data would be parsed.