This is sample content, not analysis. It exists so you can see how an
article looks and what formatting is available. Delete
src/content/articles/en/sample-anatomy-of-an-article.md (and its Japanese
translation) once you have published a real piece.
Headings structure the page
The headline at the top of this page is the only h1. Everything you write
starts at ## — that keeps the heading hierarchy correct for screen readers
and for Google. Use ### for sub-points beneath a ##.
A third-level heading looks like this
Body text is set in a sans-serif face at a comfortable measure — around 68 characters per line, which is the range most readers find easiest.
Numbers are always monospace
That is the visual signature of this publication. Dates like 2026-08-04, ticker codes like 1518, and figures in tables are set in a monospaced face so columns line up and the page feels like a terminal.
To get right-aligned monospaced figures in a table, mark the column as right-aligned with a colon in the separator row:
| Company | Code | Buyback (¥bn) | % of shares |
|---|---|---|---|
| Mitsui Matsushima | 1518 | 4.2 | 4.35 |
| Toyota Motor | 7203 | 410.0 | 1.02 |
| Sony Group | 6758 | 180.0 | 1.47 |
Those figures are illustrative, not real disclosures.
Lists
Unordered:
- Market themes and the Tokyo Stock Exchange reform story go in Analysis.
- Individual company work goes in Companies.
- Mechanics, tax and brokers go in Getting started.
Ordered:
- Write the Markdown file.
- Commit it.
- Cloudflare rebuilds the site automatically.
Pull quotes
Use a blockquote when you want to lift a line out of the flow — a quote from a disclosure document, or a sentence you want the reader to slow down for.
Links and emphasis
Links are set in the accent colour, like this one to the disclaimer. You can use bold for emphasis and italics for titles or Japanese terms — for example 投資助言・代理業.
Frontmatter
The block at the very top of the file between --- lines controls everything
about the article. The fields available are:
| Field | Required | What it does |
|---|---|---|
title |
yes | The headline, and the h1 |
description |
yes | The standfirst, and the default meta description |
subtitle |
no | Use if you want the standfirst to differ from the meta description |
metaTitle |
no | Overrides the browser/search title only |
metaDescription |
no | Overrides the search description only |
author |
no | Defaults to Takuya Inoue |
pubDate |
yes | Publication date, YYYY-MM-DD |
updatedDate |
no | Shown in the byline when set |
category |
yes | analysis, companies or getting-started |
tags |
no | A list, e.g. ['governance', 'buybacks'] |
tickers |
no | A list of codes, e.g. ['1518'] |
cover |
no | A lead image, placed next to the article file |
coverAlt |
no | Required whenever cover is set |
readingTime |
no | Overrides the automatic estimate |
draft |
no | true hides it from the live site |
featured |
no | true makes it the homepage lead |
Reading time is calculated for you, so you can leave it out.
Writing in Japanese
If you translate this article, save the translation at
src/content/articles/ja/sample-anatomy-of-an-article.md — the same filename,
in the ja folder. That is the only thing that links the two versions
together. The language switcher then appears automatically, and the correct
hreflang tags are emitted on both pages.
If you never write the translation, no Japanese page is created and no switcher is shown. That is intentional.