Add ability to ignore YAML front matter

[eggshell]

Since github officially supports jekyll as its static site generator for github pages, there should be a way to ensure front matter can be excluded from rendering when being displayed on github.com

[kivikakk]

This a tricky one; do you have any suggested implementations? We could scan the front matter for a particular key, for instance.

[andyjeffries]

I was just looking for this and was going to build it in my app. I'm planning on doing it like this:

html = my_markdown.gsub(/\A\-\-\-(\r\n?|\n).*?\-\-\-(\r\n?|\n)+/m, '')

That removes an initial line of --- followed by an OS-flexible line break, then a minimum number of characters until a closing --- and one or more OS-flexible line breaks.

Might help...

[kivikakk]

@andyjeffries 👋 Thanks for that! Seeing as we're already parsing it out, I think the actual act of removing it should be simple; my concern is more around controlling how we trigger the behaviour. I'm struggling to come up with a neat way to do this that doesn't feel orthogonal to the design.

[morallo]

What about defining a specific variable yaml-frontmatter-display: false inside the frontmatter itself?

[mwestphal]

I wish this was possible. The front matter table the appears in github has no purpose.

[goto-dev-null]

I wish this was possible.

Is it not? I see this issue was mentioned in "Rework Documentation completely" but the conversation seemed to be inconclusive.

[github-actions]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[RokeJulianLockhart]

#994 (comment)

@GitHub-Actions, it remains relevant. See actions/stale#1190 (comment).