A lot of what Scribe provides is just bundling together pre-existing plugins. They can all be configured individually, if you like.
This just plug directly into Eleventy. If you want only a few of these, you can skip Scribe and install them yourself!
eleventy-plugin-syntaxhighlight
- Provides, obviously, syntax highlighting.
On its own it provides on the HTML–for the visual effect you’ll need to add the appropriate CSS.eleventy-plugin-footnotes
- This gives you some tools for generating nice, accessible footnotes.eleventy-plugin-reader-bar
- Provides a shortcode for adding a “progress” bar while reading through a page.These plug into markdown-it
, a JavaScript-based markdown renderer
(in fact it’s the renderer Eleventy uses internally).
In addition to these plugins, Scribe applies some other customizations to the markdown engine.
markdown-it-anchor
- Gives your headings anchors so they can be linked to.markdown-it-toc-done-right
- This gives you the [[toc]]
tag which can be inserted into your markdown files to generate a simple table of contents from their headings.
Uses markdown-it-anchor
.markdown-it-container
- This provides a generic “container” system for wrapping blocks of content in Markdown.
Scribe uses it for its “Admonitions” feature, but you can also use it for anything else you like.markdown-it-emoji
- Add the capability to use emoji shortcodes instead of the emoji themselves.
i.e. :elf:
is rendered as 🧝!