Create a post#

pnpm new:post "My first post" --description "One sentence about it." --tags notes --publish

That creates content/posts/my-first-post.md. The file name is the URL: /blog/my-first-post. Without --publish the post is a hidden draft, so you can write in peace and publish later.

Frontmatter#

Every post starts with a block between --- lines:

• title, description and published are required. The description is used on cards, in search results and in feeds.
• published can be a date (2026-11-10) or a date with a time (2026-11-10T14:30). Posts are listed newest first, and the time orders posts from the same day.
• tags become topic pages and filter chips.
• projects lists project names from content/github-projects.ts; the post then shows them as "where I use this" cards.
• cover is optional: a finished 1200x630 JPEG under content/public/, with the title already on it.
• aliases lists former slugs. If you rename a post, put the old name here and the old link redirects.
• draft: true hides the post everywhere.

Callouts#

Code#

Fenced code is syntax highlighted:

export const greet = (name: string) => `Hello, ${name}!`;

A prompt block is a prompt readers can copy or open in Claude or ChatGPT:

Explain what a callout is and when to use one in a blog post.

Figures#

A figure is a small Svelte component that plays on its own while it is on screen. This one is registered in content/figures/index.ts:

Figure: An example figure: write, check, ship, on a loop. Open the interactive figure

To add your own, create a component next to ExampleFigure.svelte, register it in that index with a caption and a text description, and put ::figure your-id on a line of its own. Feeds and the Markdown copy use the caption and description instead of the component.

Images#

Put image files in content/public/images/ and reference them with a path starting with /images/.

Before you publish#

Run pnpm check-content. It tells you what is missing or still a starter value.