My Zola cheatsheet

Most Markdown works as expected, but here are some less obvious things you can do. You can also include HTML.

Add a table of contents

{{/* toc() */}}

More options here: ~/tabi • Table of Contents

Reference links

[Zola][zola]

[zola]: https://www.getzola.org

Internal links

[Link to this page](@/notes/Blogging/my-zola-cheatsheet.md)

Images with labels on hover

![Sardinia climbing](https://climbingitaly.com/sector-img/pedra-longa-1.jpg "Want to go there") 

Footnotes

This is a sentence which appears here.[^1]

[^1]: This is the footnote which appears at the end.

YouTube shortcode

Shortcodes allow you to define shortcuts for HTML snippets or loading data

More shortcodes here: ~/tabi • Custom shortcodes

(See source code for how to escape shortcodes)

{{/* youtube(id="5BYxzH9uBRg") */}}

Callout shortcode

{%/* admonition(type = "tip") */%}
This is important
{%/* end */%}

Available types: note, tip, info, warning, danger

Aside shortcode

{%/* aside(position = "right") */%}
This is an aside
{%/* end */%}

Remote text shortcode

```r
{{/* remote_text(src="https://raw.githubusercontent.com/prcleary/rename_pdf/refs/heads/master/rename_pdf.R") */}}
```

Mermaid diagram shortcode

Need to add mermaid = true in [extra] section of frontmatter

{%/* mermaid(invertible = true, full_width = true) */%}
flowchart TD
    A[Christmas] -->|Get money| B(Go shopping)
    B --> C{Let me think}
    C -->|One| D[Laptop]
    C -->|Two| E[iPhone]
    C -->|Three| F[fa:fa-car Car]
{%/* end */%}

Spoiler shortcode

*... and the murderer was {{/* spoiler(text="the podiatrist", fixed_blur=false) */}}!*

KaTeX for formulas

$y = \frac{x^3}{z}$

Emoji examples

More here: ikatyang/emoji-cheat-sheet: A markdown version emoji cheat sheet

Useful links:

• Tera, the syntax used for shortcodes: Tera
• Zola discourse group: Zola