this post exists so a freshly set-up site renders something real, and so every styled element can be checked in one place. delete it once the site has content of its own.

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 footnote1.

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

column column column
left aligned some value 1
another row another value 2
third row third value 3

images

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

example image

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>

  1. footnotes render at the bottom of the post, with a superscript marker. ↩