This is a post. It lives in its own folder:

content/posts/hello-world/
  index.md      <- this file
  (images go here too)

Everything about a post lives in that one folder, which means adding a picture is just uploading it here and writing its filename. No paths to get right.

Adding a picture

Upload the image into this folder, then write:

![a short description of the picture](my-photo.jpg)

That is the whole thing. The text in the square brackets is what screen readers read out and what shows if the image fails to load, so it is worth writing.

Formatting

Regular Markdown works:

  • bold with **bold**
  • italic with *italic*
  • a link with [link](https://example.com)

Quotes look like this.

The bit at the top

The block between the +++ lines is the post’s settings. Only title really matters. date controls the ordering, description is the grey line shown in the post list, and tags are optional.

To hide a post while you work on it, add draft = true under the title. It will not appear on the site until you remove that line.