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.

Glassforge AI

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 a2+b2=c2a^2 + b^2 = c^2. Display math goes between double dollar signs:

softmax⁡(z)i=ezi∑jezj\operatorname{softmax}(z)_i = \frac{e^{z_i}}{\sum_{j} e^{z_j}}
$$
\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

ElementSource
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]

A caption states the point of the figure, so a reader who only skims still gets it.
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.

utilization trend 0.00
payment rhythm 0.45
account age 0.15
recent inquiries 0.91
merchant mix 0.00
balance volatility 0.57
Synthetic data, for demonstration. Each row is one feature and each column is one step in a sequence. Drag the slider to read the values at a step.
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

  1. Footnotes collect at the end of the post, with a link back to where they were cited. ↩