Search the site

Back to all posts
Notes

Writing with Markdown

A tour of every element you can use in a post: headings, emphasis, lists, code, tables, quotes, and images.

On this page
  1. Headings
  2. Text and emphasis
  3. Lists
  4. Code
  5. Tables
  6. Quotes and images

This post is a living cheatsheet: it shows how each Markdown element looks in the template. Use it as a reference while you write, and delete it once you no longer need it.

Every post starts with a small block of data (the frontmatter) between lines of three dashes:

---
title: "My post"
description: "A one- or two-sentence summary."
date: 2026-01-20
lang: en
category: notes
tags: ["Markdown"]
---

Headings

Use ## for sections and ### for subsections. The top level (#) is reserved for the title, so inside the text start at ##. Headings show up on their own in the article’s side table of contents.

Text and emphasis

You can make text bold, italic, or inline code to refer to a command or a file name. Links work too and, if you need it, you can strike something through.

Lists

Unordered lists are good for loose ideas:

  • First point
  • Second point, with a detail
  • Third point

And ordered ones for steps that go in sequence:

  1. Write the file
  2. Fill in the frontmatter
  3. Publish

Code

Inline code goes between backticks, like pnpm dev. For longer blocks, use three backticks and name the language so it gets highlighted. Each block comes with a copy button:

pnpm install
pnpm dev
function greet(name) {
  return `Hello, ${name}`;
}

console.log(greet("world"));

Tables

Tables are handy for comparing things at a glance:

Element Syntax What for?
Bold **text** Emphasize an idea
Link [text](url) Point to another page
Code `code` Name a command or a file

Quotes and images

Blockquotes highlight a sentence or a reference:

The best way to learn something is to write about it afterwards.

And images are inserted with a single line; they scale to the page width on their own:

A mountain of books on a table

That covers almost everything you’ll need. From here on, the rest is just writing.

Grimorio
Grimorio / Grimorio

Guides, notes, and stories.