Additional Markdown features of the ReadMe platform implementation.
We've also built a lot of great features right in to the ReadMe app, which work on top of our markdown engine to give your developers a best-in-class documentation experience. These features aren't all baked in to the new engine itself, but they're worth mentioning nonetheless!
If you've set up JWT logins and user variables in your ReadMe project, you can use the double angle-bracket notation for variable expansions. So if you're logged in to and have a
name variable set, then this…
Hi, my name is <<name>>!"
…should expand to “Hi, my name is Generic User!”
Did you know you can define various technical terms for your ReadMe project? Using our glossary feature, these terms can be used anywhere in your Markdown! Just use the same double angle-bracket syntax you would for user variables with a “glossary:” prefix before the term, like so:
Both <<glossary:exogenous>> and <<glossary:endogenous>> are long words.
Which expands to: “Both exogenous and endogenous are long words.”
You can use GitHub-style emoji short codes (feat. Owlbert!)
This expands out to: “ ”
- Markup-based TOC generation.
- Auto-generated heading anchors.
- Variable and glossary term expansions will render in code blocks even if they've been manually escaped by the author.
Updated over 1 year ago