On Starting to Write in Public
The real voyage of discovery consists not in seeking new landscapes, but in having new eyes. Marcel Proust
This is a sample post. It exists so you can see how a finished piece looks, and so you have a template to copy. Delete it whenever you’re ready to publish something real.
Writing a new post
Every post is a single Markdown file in src/content/writings/. The block of
metadata at the top — between the --- lines — is called frontmatter. Only
title and date are required. The filename becomes the URL, so
real-world-superintelligence.md publishes at /writings/real-world-superintelligence/.
What you can write
Markdown handles the usual things: bold, italic, links, and lists. You also get proper footnotes,1 which render at the bottom of the page and link back and forth.
Block quotes are set off with a left rule, the way an aside or a pulled quote should be.
Longer quotations, section breaks, and images all work out of the box. The column is kept narrow on purpose — around sixty characters a line — because that is what is comfortable to read.
Section headings
Use ## for section headings and ### for anything nested beneath them. They’re
spaced generously so the page breathes.
That’s the whole system. Write a Markdown file, commit it, and it’s live.
Footnotes
-
Footnotes are good for citations, asides, and the occasional joke you don’t want to interrupt the main line of thought. ↩