eleventy-plugin-markdown-shortcode

An Eleventy plugin to render markdown as a shortcode within other templating engines.

Thanks to Bryan Robinson for the Eleventy Plugin tutorial

Installation

Available on npm.

``
npm install eleventy-plugin-markdown-shortcode --save
`

Open up your Eleventy config file (probably .eleventy.js) and add the plugin:

`
const markdownShortcode = require("eleventy-plugin-markdown-shortcode");
module.exports = function(eleventyConfig) {
eleventyConfig.addPlugin(markdownShortcode);
};
`

Usage

This plugin is a universal shortcode, so it's available in the following templating engines:

* Liquid
* Nunjucks
* Handlebars
* JavaScript

In your templates, use the following syntax to grab the contents from any markdown file in your project path:

`
{% markdown '/path/to/markdown.md' %}
`

$3

We handle (read: ignore) frontmatter with the markdown-it-front-matter plugin. You can include standard frontmatter like so:

`
---
title: Frontmatter test
---

This is from the frontmatter test file

It should not include anything that says title or the frontmatter dashes.
`

And the plugin will skip the frontmatter, as long as it's valid

Configuration

You can also pass in markdown-it configuration like so:

`
eleventyConfig.addPlugin(markdownShortcode, {
html: true,
linkify: true,
});
``

Example

View a live demo

Read the live demo source code

Issues

Having problems? File an issue on GitHub