Writing Posts: Markdown, Code & Typography

You write in plain Markdown (kramdown), and System Halted styles the result for both light and dark mode. This post doubles as a reference — it exercises the elements you’ll reach for most.

Code, highlighted

Fenced code blocks are syntax-highlighted by Rouge. Here’s a little Ruby:

class Greeter
  def initialize(name)
    @name = name
  end

  def greet
    "Hello, #{@name}!"
  end
end

Greeter.new("world").greet

And some YAML, the language your front matter speaks:

layout: post
title: "My First Post"
categories:
  - Writing
tags:
  - hello

You can also use inline code mid-sentence.

Tables

Blockquotes and lists

Good typography is invisible. You notice it only when it’s missing.

An ordered list:

1. Write the post in Markdown.
2. Add front matter (title, categories, tags).
3. Run bundle exec jekyll serve.

And an unordered one:

• Headings, bold, and italic all just work.
• Links are styled to match the active theme.
• Images get rounded corners automatically:

That’s the full toolkit — drop in your words and the theme handles the rest.