Blog New Post

blog-new-post

Create a new post directory plus a starter source file in the chosen format, pre-filled with the metadata block matching that format.

Inputs

Ask only for what's missing:

• <title> — required. Free-text post title.
• <slug> — derived from title if not given (lowercase, hyphenated,

punctuation stripped).

• <date> — defaults to today's date (YYYY-MM-DD). Pull from the

currentDate context if available.

• <format> — one of typst, markdown, mdx, latex. Default

typst to match the surrounding project.

• <parent-dir> — defaults to content/ at the project root.
• <author> — optional. Don't invent — leave blank if unknown.

Output

Create:

<parent-dir>/<date>-<slug>/
├── index.<ext>          # starter file in the chosen format
└── (no images yet)

Where <ext> is typ / md / mdx / tex.

Starter templates

Typst (index.typ)

#metadata((
  title: "<TITLE>",
  description: "<one-line summary>",
  date: "<YYYY-MM-DD>",
  lang: "en",
)) <post>

= Background

Write here.

= Method

== Subsection

$ y = f(x) $

= Discussion

The post sources do not import /config.typ or use #show: template.with(...). The renderer (Claude Code) reads the #metadata((...)) <post> dict directly. Use a plain ISO date string "YYYY-MM-DD", not a Typst datetime(...) call.

Markdown (index.md)

---
title: "<TITLE>"
description: "<one-line summary>"
date: <YYYY-MM-DD>
lang: en
tags: []
---

## Background

Write here.

## Method

### Subsection

$$ y = f(x) $$

## Discussion

MDX (index.mdx)

export const meta = {
  title: "<TITLE>",
  description: "<one-line summary>",
  date: "<YYYY-MM-DD>",
  lang: "en",
};

## Background

Write here.

## Method

$$ y = f(x) $$

LaTeX (index.tex)

\documentclass[11pt]{article}
\usepackage{amsmath, amssymb, amsthm}
\usepackage{hyperref}

\title{<TITLE>}
\author{}
\date{<YYYY-MM-DD>}

\begin{document}
\maketitle

\begin{abstract}
<one-line summary>
\end{abstract>

\section{Background}

Write here.

\section{Method}

\subsection{Subsection}

\[ y = f(x) \]

\section{Discussion}

\end{document}

Steps

1. Resolve inputs. Ask only for what's missing. Default date = today, default format = typst, default parent = content/ at the project root. 2. Compute slug. Lowercase, words joined by -, drop punctuation. Confirm uniqueness — if the directory already exists, append -2. 3. Write the directory and starter file with the format-specific template above. Substitute <TITLE>, date components, etc. 4. Report the new path and the next step: "Edit `<path>/index.<ext>`, then ask me to render it (`blog-build`)."

Anti-goals

• Don't create images/ or assets/ subfolders preemptively — let the

user add files when needed.

• Don't fill in author, affiliation, or tags. Leave those blank.
• Don't write a refs.bib unless the user asks.