# Introduction

> Typemark turns your MDX pages into a fast, searchable docs site. Write in the browser, publish when you're ready.

Typemark takes you from a blank page to live docs in a few minutes. You write in a visual editor or in raw MDX, Typemark builds the site, and every page lives as an MDX file in a Git repo you can take with you.

<Callout type="info">
  New here? The [Quickstart](https://docs.typemark.dev/quickstart) takes you from signup to a live site. This page explains what you're working with.
</Callout>

## What you get

<CardGroup cols={3}>
  <Card title="Write, don't configure" icon="pencil">
    A visual editor with slash commands, or source mode for raw MDX. Your call.
  </Card>
  <Card title="Publish on save" icon="bolt">
    Saves go live on their own. Want to batch changes? Switch to manual publishing.
  </Card>
  <Card title="Git under the hood" icon="code-bracket">
    Every project is a Git repo. Let Typemark host it, or sync it with GitHub.
  </Card>
</CardGroup>

## How it works

<Steps>
  <Step title="Name your docs">
    Sign up and pick a name. Typemark creates the repo, adds three starter pages, and reserves your address at `your-slug.typemark.dev`.
  </Step>
  <Step title="Write">
    Open the editor and start typing. Type `/` to add code blocks, callouts, tabs, cards, and more. Or switch to Source and write MDX.
  </Step>
  <Step title="Go live">
    New sites start offline, so you can get things right first. When you're ready, click **Go live**. From then on, every save publishes.
  </Step>
  <Step title="Connect GitHub (optional)">
    Sync with a GitHub repo and edit wherever you like. Edits in Typemark and pushes to GitHub both update your site.
  </Step>
</Steps>

## Built in, not bolted on

Every site comes with full-text search, a dark mode toggle, syntax highlighting, a table of contents, a sitemap, and meta tags. You can put it on your own domain and publish it in [several languages](https://docs.typemark.dev/configuration/languages) on any plan. Turn features on or off in [`typemark.json`](https://docs.typemark.dev/configuration/typemark-json).

## Ready for AI agents

Every live site serves an `llms.txt` file and an MCP server, and each page is also available as Markdown. Claude, Cursor, and other AI tools can read your docs directly. You'll find the URLs under **For AI agents** on your project's overview, and the details in [Agent-ready docs](https://docs.typemark.dev/ai/agent-ready).

## Free to start, Pro when you need it

The Free plan covers one project with up to three editors, and as many viewers as you like. Pro adds [AI search](https://docs.typemark.dev/ai/ai-search) on your site, [AI writing](https://docs.typemark.dev/editor/ai-writing) in the editor, [AI translations](https://docs.typemark.dev/ai/ai-translations), [previews of pull requests](https://docs.typemark.dev/github/previews) and [branches](https://docs.typemark.dev/editor/branches), [analytics](https://docs.typemark.dev/configuration/analytics), [custom CSS and scripts](https://docs.typemark.dev/configuration/custom-code), [password-protected docs](https://docs.typemark.dev/configuration/private-docs), and branding removal.

Enterprise is everything in Pro, plus unlimited editors, [single sign-on](https://docs.typemark.dev/team/single-sign-on), an [audit log](https://docs.typemark.dev/team/audit-log), and [private docs for the people you choose](https://docs.typemark.dev/configuration/private-docs#let-in-only-the-people-you-choose). See [Billing](https://docs.typemark.dev/team/billing) for the details.

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket-launch" href="https://docs.typemark.dev/quickstart">
    Create your docs site and take it live.
  </Card>
  <Card title="MDX components" icon="cube" href="https://docs.typemark.dev/components/callouts">
    Callouts, tabs, cards, steps, and accordions: the building blocks for great docs.
  </Card>
</CardGroup>
