HotDocs: Markdown
HotDocs evaluates Ruby code on your server when rendering. Only use it for trusted markdown content.
The runtime needs deno
to compile markdown files.
Markdown support is currently under development. You can chime in on this GitHub discussion to share wishes and feedback.
HotDocs supports templates ending in .mderb: you can mix markdown and erb in the same template.
Behind the curtains, .mderb templates are compiled first as .erb and second as .md with unifiedjs
.
Syntax highlight
HotDocs highlights code blocks with PrismJS.
You can customize the css styles by editing prism.css or picking another theme
.
Admonitions
On top of the markdown syntax, HotDocs supports admonitions as follows (icons from Heroicons ):
:::info
This is an info.
:::
:::tip
This is a tip.
:::
:::warning
This is a warning.
:::
:::danger
This is a danger.
:::
This is an info.
This is a tip.
This is a warning.
This is a danger.
Adding deno to Heroku
You can check if deno is already installed in your Heroku app with:
heroku buildpacks
If deno is not yet installed, you can do so with:
heroku buildpacks:add --index 1 https://github.com/3v0k4/heroku-buildpack-deno.git