How to escape nunjucks in markdown files in Eleventy

This issue occurs when you want to write a post or wiki that illustrates how to use nunjucks syntax

Let's say you intend to write this:

Output a date with {{'1/1/2010' | dateDisplay}}

But what gets rendered is this

Output a date with January 1st 2010

That's because when markdown files are processed through eleventy, we can extend the available markdown syntax with templating options as well. In our case, we're using nunjucks by setting it in the configuration file:

                    Copy
                    
                 
module.exports = {
    markdownTemplateEngine: "njk"
};

Here are the criteria we'll try to optimize for:

• Output looks good when built with eleventy
• Source looks good when rendered w/ Markdown preview (in editor / github)
• Source code is easy to read and maintain for developers
• Doesn't break page-wide nunjucks templating

Nunjucks has three types of tags:

• {{ output }}
• {% logic %}
• {# comment #}

Overriding the template language