> ## Documentation Index
> Fetch the complete documentation index at: https://www.lettercamp.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Write pages

> Create Markdown and MDX articles, understand their URLs, and control which pages are published.

Write Lettercamp articles as `.md` or `.mdx` files directly inside `pages/`.
Use Markdown for text and built-in blocks. Use MDX when you also want to import
[custom React components](https://www.lettercamp.com/docs/react-components.md).

## Create an article

Create `pages/hello-world.mdx`:

```mdx theme={null}
---
title: "Hello, world"
description: "A first note from our team."
date: "2026-11-05"
---

Welcome to our publication.

## What to expect

- Product updates
- Practical guides
- Stories from our team
```

The filename determines the article URL: `hello-world.mdx` becomes
`/hello-world/`. Keep articles directly in `pages/`; nested article folders are
not included by the CLI renderer. The generated homepage lists published articles.

## Format your content

Use ordinary Markdown for headings, paragraphs, lists, quotes, links, and dividers.
[Built-in content components](https://www.lettercamp.com/docs/components/overview.md) add images, media, tables,
code blocks, and key takeaways without imports. In the web editor, use **Source**
to edit Markdown or MDX directly.

## Keep an article as a draft

Add `draft: true` to the frontmatter to exclude the article from local previews
and published builds. Set `draft: false` or remove the field to include it again.
Use the web editor's **Preview** to inspect draft content.

Draft source still belongs to your publication files. If you put those files in
a public GitHub repository, other people can read them there.

## Preview your changes

Run `npm run dev` in a project created by the CLI, or follow
[Local preview](https://www.lettercamp.com/docs/cli/dev.md). Save your file to reload the preview.

See [Article metadata](https://www.lettercamp.com/docs/writing/metadata.md) for titles, descriptions, dates, and covers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.