Writing with awkward

A tour of the markdown

Published

Pages are markdown with a few additions for Tufte CSS. This page uses all of them.

Inline formatting

Text can have emphasis, strong emphasis and inline code. Links point to other pages by name, or anywhere else. Sidenotes are numberedLike this one. and margin notes are not.A margin note has no number.

Blocks

Lists

The second item above is written as:

- Items may continue on the next line, indented by two spaces, and are joined
  into a single item, so a long item can be written across several lines of
  markdown and still wraps as one.
  1. Ordered lists use numbers.
  2. One level only.

Quotes and code

Simplicity is prerequisite for reliability.

Edsger W. Dijkstra
awk '{ print $1 }' file

Tables

ScriptGenerates
meta.awkthe head tag
header.awkthe site header
content.awkthis article
footer.awkthe site footer

Figures

A diagram of the build
How a page is built from four parts

find content static -type f | sort | awk -f src/lib.awk -f src/index.awk -v today=2026-10-06 > work/page-index