---
title: "Get started"
description: "Preview your site and make your first change."
url: "https://stage04-first-publish.dev-published.dev/docs/get-started.md"
section: "Docs"
---

> Breadcrumbs: Docs > Get started
> Sitemap: https://stage04-first-publish.dev-published.dev/docs/sitemap.md
> LLMS index: https://stage04-first-publish.dev-published.dev/docs/llms.txt

# Get started

A publishOS site starts with a folder. The `publish.os/` folder contains your content, theme, and configuration.

These guides are examples you can edit. The theme controls their appearance. Your words stay in MDX files.

Local previews and builds do not require an account.

## Preview the site

From your project directory, run this command:

```bash title="Preview the site"
npx @publish.os/cli@latest dev
```

Open the address that the CLI shows. To stop the preview, press `Ctrl`+`C`.

## Make one change

Open this page, `publish.os/docs/content/get-started.mdx`. Replace this paragraph with a description of your project. Save the file.

## Write in MDX

Use Markdown for normal text. You can use **bold text**, *italic text*, and `code`.

You can also use MDX components to add interactive elements to your pages.

Use the [blog](/blog) to share updates alongside your documentation.

You can show a keyboard shortcut such as `Ctrl`+`Enter`.

## Create a new page

Create `publish.os/docs/content/hello-world.mdx` with this content:

```mdx
---
title: Hello World
description: Add a page to your site.
---

Each MDX file contains one page.
```

Next, organize your [groups](/docs/groups) or customize your [theme](/docs/themes).

## Continue reading
- Next: [Groups](https://stage04-first-publish.dev-published.dev/docs/groups.md)

## Section links
- [Docs home](https://stage04-first-publish.dev-published.dev/docs)
- [LLMS index](https://stage04-first-publish.dev-published.dev/docs/llms.txt)
- [Sitemap](https://stage04-first-publish.dev-published.dev/docs/sitemap.md)