Skip to main content
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.

Create an article

Create pages/hello-world.mdx:
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 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. Save your file to reload the preview. See Article metadata for titles, descriptions, dates, and covers.