marp-team / marp-core

The core of Marp converter
MIT License
797 stars 132 forks source link

Front-matter variables? #387

Open boldandbusted opened 1 month ago

boldandbusted commented 1 month ago

Howdy. I'd like to use "front matter" variables in the Markdown, including in headings. Is this possible? I have made some attempts, but the heading doesn't interpret the {{ }}, it prints it literally.

I'm using this as the guide (referenced in the Marp docs): https://jekyllrb.com/docs/front-matter/#custom-variables

I'd like to do something like the following:

---
title: Making money - is it possible?
---

# Welcome to "{{ page.title }}"

# Here begins my presentation

## This is my slidedeck
## No one can make a slidedeck like I can
### I have very low hubris

Here, the first slide should contain this rendered text:

Making money - is it possible?

I hope this makes sense.

yhatt commented 1 month ago

Front-matter variables are Jekyll specific feature. Marp has no feature to use variables because that feature is not defined in CommonMark. (Marpit has mentioned to Jekyll for describing how to define front-matter, but no meaning that is implemented all features)

You should use a plugin if you want to use: marp-team/marp#510

boldandbusted commented 1 month ago

Ah, I see. Thanks for the reply. I think referring to that Jekyll document implies that Marp implements all the features shown there. :) It might be useful to other readers to narrow the scope in the documentation. Cheers!