Welcome to the Journal
What this journal is for, and how its articles are put together.
This is a home for long-form writing: notes, experiments and essays that need more room than a commit message and more care than a chat thread.
How articles are published
Every article lives in the repository under apps/journal/articles/, filed by year and month. A push
to master builds every article that isn't a draft and publishes the result to Cloudflare Pages.
Drafts — anything with .draft in its name — stay in the repository and never reach the site.
What an article can be
An article can be written in Markdown or HTML. Markdown is turned into HTML when the site is built, with support for maths like , footnotes,1 highlighted code and figures. An article that needs its own images, figures or scripts gets a folder of its own.
Footnotes
-
Like this one. ↩