How to write a post for this blog
Everything a post on this site can do, in one place. Math, code, tables, figures, margin notes and an interactive figure.
Sample post. It ships with the site to show what a post can do. Replace or delete it before launch.
This post is a working reference. Each section shows one thing a post can do, followed by the source that produced it. Open src/content/research/writing-a-research-post.mdx next to this page and compare.
Starting a post
A post is one .mdx file in src/content/research/. The file name becomes the address, so my-first-result.mdx is published at /research/my-first-result/. The top of the file describes the post:
---
title: A short, specific title
date: 2026-11-18
summary: One or two sentences. Shown under the title, in lists and in the RSS feed.
authors: [First Author, Second Author]
tags: [Interpretability]
draft: true
---
Leave authors out to credit the company. A post with draft: true appears while you run the site locally and is left out of the published build.
Text
Write ordinary Markdown: paragraphs, bold, italic, links, lists and quotes.
- Keep paragraphs short.
- Put the conclusion first.
- Define a term the first time you use it.
A quote is set off with a rule in the accent colour.
Margin notes
A margin note holds a detail that would interrupt the argument: a caveat, a definition or a pointer to related work. Place it just before the paragraph it belongs to.
<Sidenote>
This is a margin note.
</Sidenote>
For a plain reference, a footnote is enough.1
Math
Inline math goes between single dollar signs, like . Display math goes between double dollar signs:
$$
\operatorname{softmax}(z)_i = \frac{e^{z_i}}{\sum_{j} e^{z_j}}
$$
Code
Fence code with three backticks and name the language to get highlighting:
def relu(x):
return max(0.0, x)
Tables
| Element | Source |
|---|---|
| Margin note | <Sidenote> |
| Figure | <Figure caption> |
| Footnote | [^1] |
| Inline math | $ ... $ |
Figures
Wrap an image or a chart in Figure and give it a caption that says what the reader should notice.
[YOUR IMAGE OR CHART]
import Figure from '../../components/Figure.astro';
import chart from './my-chart.png';
<Figure caption="What the reader should notice.">
<img src={chart.src} alt="Describe the chart for someone who cannot see it." />
</Figure>
Interactive figures
A figure can respond to the reader. The one below is a pattern to copy from src/components/figures/FeatureHeatmap.astro. It reads fully without JavaScript, and the script only adds the slider.
import FeatureHeatmap from '../../components/figures/FeatureHeatmap.astro';
<FeatureHeatmap />
Give each new figure its own component in src/components/figures/. The page ships no JavaScript except what the figures on it need.
Footnotes
-
Footnotes collect at the end of the post, with a link back to where they were cited. ↩