8 Jun 2026

Formatting Sampler

Markdown examples: headings, tables, quotes, code, links, and lists.

This page demonstrates common Markdown structures in one place.

Checklist

  • Drafted in Markdown.
  • Rendered through the default single-post template.
  • Tagged and indexed like any other page.
  • Kept separate from the real posts collection.

Comparison Table

Pattern Good for Archive impact
Plain note Short thoughts Minimal metadata
Field log Repeatable observations Rich front matter
Gallery essay Narrative plus photos Reusable photo IDs
Reference page Durable notes Headings and tables

Quote

Markdown stays readable as source, while Hugo templates decide how polished the public page should look.

Code

params:
  kind: reference
  visibility: public
  locationPrecision: none

Internal links can point to other archive pages, such as the gallery essay, while external links can use ordinary Markdown syntax.

Markdown source

This page demonstrates common Markdown structures in one place.

## Checklist

- Drafted in Markdown.
- Rendered through the default single-post template.
- Tagged and indexed like any other page.
- Kept separate from the real `posts` collection.

## Comparison Table

| Pattern | Good for | Archive impact |
| --- | --- | --- |
| Plain note | Short thoughts | Minimal metadata |
| Field log | Repeatable observations | Rich front matter |
| Gallery essay | Narrative plus photos | Reusable photo IDs |
| Reference page | Durable notes | Headings and tables |

## Quote

> Markdown stays readable as source, while Hugo templates decide how polished the
> public page should look.

## Code

```yaml
params:
  kind: reference
  visibility: public
  locationPrecision: none
```

## Links

Internal links can point to other archive pages, such as
[the gallery essay]({{< ref "/sample-posts/gallery-essay" >}}), while external
links can use ordinary Markdown syntax.