posts live in _posts/ and must be named YYYY-MM-DD-title.md. the date and slug in the filename become the url — with the permalink setting in _config.yml, this post lands at /2026/07/27/example-post/. posts dated in the future stay unpublished, because future: false is set.

headings

headings are prefixed with their markdown hashes by the stylesheet, so ## renders as a visible ##. six levels exist; four are styled.

third level

fourth level

text

regular paragraph text with emphasis, strong, inline code, a link, and a footnote¹.

a blockquote. it picks up a left border and the brand colour.

second paragraph inside the quote.

a horizontal rule renders as ---, above.

lists

• unordered items are prefixed with a hanging dash
• second item
  • nested item
• third item

1. ordered items use a css counter
2. second item
3. third item

code

fenced blocks are highlighted by rouge, styled in _sass/minima/_syntax-highlighting.scss:

def greet(name)
  puts "hello, #{name}"
end

greet(ENV.fetch("USER", "world"))

./serve.sh          # local preview with livereload
./deploy.sh -n      # dry run, changes nothing

table

images

images go in assets/. reference them through relative_url so they keep resolving if the site ever moves to a subpath:

any format works — svg, png, jpg. naming them after the post they belong to (assets/2026-07-27-example.png) keeps the folder navigable as it grows.

embedded video

wrap an iframe in .video-container to get a responsive 16:9 embed:

<div class="video-container">
  <iframe src="…" frameborder="0" allowfullscreen></iframe>
</div>