How to make a series of tutorials? 🔗

Tutorials:
{%
set tutorials = [
    { "label": "My tutorial 1", "link": "/tutorials/tutorial1.html" },
    { "label": "My tutorial 2", "link": "/tutorials/tutorial2.html" }
]
%}


{% for tutorial in tutorials %}
- [{{ tutorial.label }}]({{ tutorial.link }})
{% endfor %}

Gotchas 🔗

Can't add content to a template that extends another template 🔗

When you extend a template:

{% extends "base" %}

{% block title %}
    {{page.title}}
{% endblock %}

---
cant add this!!!

{% block hack %}
    cant add this either!!!
{% endblock %}

note that you can only override blocks that are defined in the base template,
you cannot create new blocks or add content.

Can't use TOC in a page 🔗

You must use it inside a template. This is a technical limitation, because we take the header ids from markdown-generated HTML.