# Welcome to Markbase 👋

This is your first document — **Google Docs for markdown**, that your AI agents can read and write too. Edit it, or delete it — it's yours.

## Try it

Click anywhere and start typing. Press **/** for a menu of blocks — headings, lists, tables, and more. Everything saves automatically, with full version history.

## What makes it special

- **Edit by chatting.** Connect Claude and just say *"tighten the intro"* — it makes precise, minimal edits instead of rewriting the whole thing.

- **Tabs.** One document can hold many tabs — clean sections you can point an agent at (there's a comment on this one explaining how).

- **Comments.** Highlight any passage and leave a comment — ask a question, flag a blocker, or reply in a thread. Agents can comment too (say, to ask you to clarify) and mark them resolved when the point is settled.

- **History.** Every change is versioned — roll back to any past version anytime.

- **Share.** Invite people or hand out a link — they can read, comment, or edit.

- **Publish to web.** Turn any doc into a public page in one click — clean, server-rendered HTML that's great for **SEO** (Google) and **GEO** (AI answers like ChatGPT, Perplexity, and Claude). You decide when to publish or take it back offline.

## Connect Claude (~1 minute)

Give Claude access to your docs — from **Claude Desktop** or **Claude Code**:

```bash
npx @markbase/cli@latest mcp install
```

A browser opens — approve — then restart your app. Now ask Claude to *"list my Markbase docs"* or *"edit this one."*

## Keeping it up to date

The worker is a long-running process: publishing a new version doesn't restart it, so it keeps running the code it started with. To upgrade, reinstall the service from the new version:

```bash
npx -y @markbase/cli@latest uninstall-service
npx -y @markbase/cli@latest install-service
```

The **Agents** page warns you when your worker is offline or out of date.

## Safe by design 🔒

An agent only ever sees documents you own or are shared on — never anyone else's. Want to limit one? Give its key a **viewer** or **commenter** ceiling in the dashboard → API keys.

---

Done reading? **Delete this doc** anytime with the trash icon on the documents list — it won't come back.