# Run a blog and changelog (/docs/start/guides/blog-and-changelog)

> A post list, posts with share links and copy, and a changelog, built like Sidework's letter and Diffkeel's release notes.

A blog is two Templates: [`blog`](https://next.mdxui.dev/docs/showcase/templates/blog), one list page, and [`post`](https://next.mdxui.dev/docs/showcase/templates/post), one record per post. A changelog is the same pair, with a release in each post. Sidework publishes a weekly letter this way, and Diffkeel its release notes.

## Prerequisites

- A Site's `nav` and `footer`, from [Build a landing page](https://next.mdxui.dev/docs/start/guides/landing-page).

**File: pages/archive.json**

**File: pages/issues/the-first-invoice.json**

**File: pages/changelog.json**

**File: Result**

The result, as this site renders it: https://next.mdxui.dev/pages/sidework/issues/the-first-invoice.json

## List the posts

[`post-list`](https://next.mdxui.dev/docs/sections/post-list) opens on a head (eyebrow, a title of 64, a lede of 200) and holds 1 to 24 posts. The `read` label, 16 characters, is the word on each link.

## Write each entry

Each post in the list carries its address, a tag of 20, a date as `YYYY-MM-DD` with an optional reading time, a title of 80 and a dek of 360. For more than 24 posts, split the archive into pages.

## Write a post

A post is one [`article`](https://next.mdxui.dev/docs/sections/article) section between the nav and the footer. Its head takes a back link, a tag, a dateline, a title of 80 and a dek of 360. The body runs to 12,000 characters, and each fenced code block in it names one of the [highlight languages](https://next.mdxui.dev/docs/reference/languages), or the record is refused at that block's line.

## Add share and copy

`share` takes the post's address and title, a label of 16 characters, and one to five networks: reddit, x, linkedin, bluesky and hackernews. `copy: true` puts a copy button on every code block of the body.

## Run a changelog

Give each release its own post record, tagged with its version, and list them newest first with the same `post-list`. Diffkeel's changelog is a `blog` page; each release is a `post`.

## Result

The Result is a post as it ships. Flip the Theme chips to read the same article in another Brand's typefaces.

## Next steps

  - [article](https://next.mdxui.dev/docs/sections/article): Long reading, under every Theme.
  - [Inline grammar](https://next.mdxui.dev/docs/sections/inline-grammar): Emphasis, code and links inside a field.
  - [List a directory](https://next.mdxui.dev/docs/start/guides/directory): The other list a Business publishes.