Text and emphasis

Use italics for a light nudge, bold for something important, and strikethrough when a change is worth leaving visible. You can also use inline code for names, commands, and small technical details.

Links are ordinary text: Go's documentation.

A bare URL such as https://mfridman.com also becomes a link.

Images

Images work with the usual syntax and should include useful alternative text:

A small grid of Markdown symbols

Lists and steps

Unordered lists are useful for related things:

  • A concise idea
  • Another useful detail
    • With a nested point
    • And one more
  • A final note

Use numbered lists when order matters:

  1. Write the Markdown file in articles/.
  2. Give it a title, date, and optional description.
  3. Remove draft: true when it is ready.

For a lightweight checklist:

  • Make a note
  • Read it once
  • Publish it when it is ready

Quotations

The shortest path to a useful thought is often to write a smaller one.

-- a note to self

Code

Inline code is good for a fragment. Fenced blocks are better for a complete example:

func main(){
  fmt.Println("Hello world")
}

And shell commands stay readable too:

npm run dev

A table, when comparison helps

Element Markdown Best use
Heading ## A heading Start a new idea
Link [label](url) Point somewhere useful
Code `code` Name a thing precisely

Header h1

Starlight drifted across the silent hull as the station slipped beyond the edge of mapped space. Deep below, dormant systems flickered awake, translating ancient signals into coordinates no human vessel had ever followed.

Header h2

The colony woke beneath a violet sunrise, its towers emerging slowly from the frozen mist. Overnight, something had altered the planet’s magnetic field, and every compass now pointed toward the northern wastes.

Header h3

Engines hummed softly as the shuttle descended through crimson clouds. Below, the ruins of a forgotten city stretched across the desert, its streets still glowing with power after ten thousand silent years.

Header h4

The station orbited a dying star, abandoned except for a single functioning terminal. When the explorers activated it, the screen displayed their names alongside arrival dates recorded centuries before their birth.

Header h5

A pale moon hung above the ocean world as drones skimmed its endless surface. Far beneath them, something enormous moved through the darkness, following the research vessel toward its landing site.

Header h6

For brevity. What monster uses h6.

Line break

Feels important. But also feels like a lot of vertical space?

^ Line break