---
title: "Set up in two minutes"
description: "A walkthrough of the Chat to Markdown welcome page: choose a folder or Obsidian vault, turn on your chat services, pin the extension and press Start saving."
url: https://chattomarkdown.com/docs/1.0.1/setup/
version: "1.0.1"
updated: 2026-11-04
---

# Set up in two minutes

> On the welcome page, choose a folder (your Obsidian vault works), turn on the AI services you use and allow each site when Chrome asks, then press Start saving. Your chats start saving in a minute, and from then on it runs on its own.

When you install Chat to Markdown, a welcome page opens with three steps. This page walks through each one, what you will see, and what to do if a step doesn't go as expected.

![The welcome page with the setup steps](https://chattomarkdown.com/docs/shots/1.0.1/welcome-light.webp "The welcome page opens in a new tab right after install.")

At the top right, the **Setup** tracker counts your progress from `0/3` to `3/3`. When all three are done it reads **Set up**. You can do the steps in any order; only the folder is required to start.

![The setup block on the welcome page](https://chattomarkdown.com/docs/shots/1.0.1/welcome-setup-light.webp "The setup steps on the welcome page.")

1. **Choose folder**: where your chats are saved.
2. The chat services you use, each turned on with one click.

**Start saving** is on the card below the steps. It begins saving once the folder is chosen.

## Step 1: Choose a folder

Every chat is saved as its own `.md` file in the folder you pick.

1. **Click Choose folder.** You can also click **Choose a folder** at the top of the page. Your computer's folder picker opens, starting in Documents.
2. **Pick a folder and confirm.** Select a folder (or make a new one in the picker) and click **Select** (Windows: **Select Folder**).
3. **Allow access when Chrome asks.** Chrome asks whether the extension may view and save files in that folder. Allow it. If Chrome offers **Allow on every visit**, choose it: then saving keeps working after you restart the browser.

When it worked, a chip with the folder's name appears next to the button, the button changes to **Change**, and the line under it says where new chats go, for example: New chats go into “Obsidian Vault”, with a folder for each service.

![The folder step after choosing a folder named Obsidian Vault](https://chattomarkdown.com/docs/shots/1.0.1/welcome-folder-chosen-light.webp "The chip shows the folder you chose.")

### Choosing your Obsidian vault

An Obsidian vault is an ordinary folder, so you pick it like any other. You have two good options:

- **A folder inside the vault**, such as a new `AI Chats` folder. Your chats stay together, with a folder for each service inside it.
- **The vault itself.** The service folders (`ChatGPT`, `Claude` and so on) then sit at the top of the vault. If you'd rather have them in one place, set a **Subfolder** later in **Settings → Folders and filters**.

```tree
Obsidian Vault/
  AI Chats/
    ChatGPT/
      2026-10-17 Lisbon food trip.md
    Claude/
      2026-10-21 Postgres index tuning.md
```

No Obsidian plugin is needed. Obsidian sees the new files like any other note. More in [Use with Obsidian](https://chattomarkdown.com/docs/1.0.1/obsidian/) and [Choose your folder](https://chattomarkdown.com/docs/1.0.1/folder/).

### Save images and files

Once a folder is chosen, a **Save images and files** switch appears under it: "Pictures and uploads from your chats go into an attachments folder next to each note and show inside it." It is on by default. Turn it off if you only want the text. You can change it any time in Settings; see [Choose what to save](https://chattomarkdown.com/docs/1.0.1/what-to-save/).

### If the folder step fails

- **Nothing happened when you clicked.** The picker may have opened behind the browser window. Check your taskbar or Dock.
- **Chrome says it can't open the folder** because it contains system files. Chrome doesn't let extensions use some folders, such as your whole home folder or system folders. Make a new folder (for example inside Documents) and pick that.
- **"Couldn’t use that folder. Try a different one."** Pick another folder, ideally one on your own disk rather than a network drive.
- **You clicked Cancel in the picker.** Nothing changes. Click **Choose folder** again.

Later, after a browser restart, Chrome may ask for permission again if you didn't choose **Allow on every visit**. The page then shows **Allow access**; click it and allow. See [Choose your folder](https://chattomarkdown.com/docs/1.0.1/folder/) for details.

## Step 2: Turn on the AI services you use

Every service starts off. The extension can only reach the chat sites you turn on.

![The list of chat services with buttons to turn them on](https://chattomarkdown.com/docs/shots/1.0.1/welcome-services-light.webp "Each service is one click. Chrome asks to allow its site.")

1. **Click a service** under "Which do you use? Turn them on", for example ChatGPT. The button changes to **Allow in Chrome…**.
2. **Click Allow in Chrome's dialog.** Chrome asks to let the extension read and change your data on that chat site (and on the sites it keeps pictures and files on). This is how it reads your chats.
3. **Check the sign-in state.** The service moves up as a card. It shows **Checking…**, then **Signed in** with a check mark.
4. **Repeat for every service you use.** The list of the others stays below, titled "Use others too? Turn them on" or "More services".

The extension uses the login you already have in this browser. You don't enter a password or API key anywhere.

| The card shows | What it means | What to do |
|---|---|---|
| **Signed in** | Ready to save. | Nothing. |
| **Not signed in** | You aren't signed in to that site in this browser. | Click **Sign in**, sign in on the site's tab, then come back. The page checks again on its own. |
| **Couldn’t check** | The site didn't answer as expected. | Open the site in a tab to make sure it loads, then come back. If it stays, see [Troubleshooting](https://chattomarkdown.com/docs/1.0.1/troubleshooting/). |

> [!NOTE]
> If you click **Deny** in Chrome's dialog, or close it, the service stays off and its button comes back. Click it again to get the dialog again. You can also turn services on or off later in **Settings → Chat services** or in the popup. See [Chat services](https://chattomarkdown.com/docs/1.0.1/services/).

## Step 3: Pin it to your toolbar

This step is optional. Click the puzzle icon at the top right of Chrome, then the pin next to Chat to Markdown. The page watches for it: "Waiting for you to pin it" changes to **Pinned** a moment after you pin.

If you'd rather not pin it, click **Skip this step**. The step then reads "Skipped. You can pin it any time." If you pinned it and the page still waits (this can happen in some browsers), click **Skip this step** too.

## Start saving

![The Ready to save your chats card with the Start saving button](https://chattomarkdown.com/docs/shots/1.0.1/welcome-done-light.webp "Once a folder is chosen, the card is ready.")

1. **Start saving** begins the first sync.

Below the steps, a card tells you what will happen. Once a folder is chosen it reads **Ready to save your chats**, with a line like:

> Start, and all your ChatGPT, Claude, Gemini and Perplexity chats are saved to “Obsidian Vault”. After that, new ones are saved every 3 hours.

On Free it says your latest chats, up to 10 in all, are saved, and kept up to date. See [Free and Pro](https://chattomarkdown.com/docs/1.0.1/free-and-pro/). If no service is signed in yet, the line ends with what to do first.

Click **Start saving**. Until you do, nothing is saved automatically, not even when you leave a chat. (A chat you save yourself with the Save button is saved right away.)

## What the first sync does

After **Start saving**, the card changes as the first sync runs:

![The card while the first sync runs](https://chattomarkdown.com/docs/shots/1.0.1/welcome-first-sync-light.webp "The first chats appear in the list as they are saved.")

- The title reads **Saving your first chats**, with a progress bar and a line such as `ChatGPT: 3 of 10` or "Looking for your chats…".
- The last five chats saved appear in a list, each with its service's logo.
- When it finishes, the title reads **Your chats are saved** and a **See saved chats** button opens [the reader](https://chattomarkdown.com/docs/1.0.1/reader/).

What gets saved depends on your plan:

- **Free** saves your latest chats, up to 10 in all across every service you turned on, and keeps those 10 up to date. See [Free and Pro](https://chattomarkdown.com/docs/1.0.1/free-and-pro/).
- **Pro** saves every chat you have ever had, newest first, a batch at a time. A long history can take a while, because the extension only goes as fast as each chat site allows. It carries on in the background, even after you close the page or the browser. See [How saving works](https://chattomarkdown.com/docs/1.0.1/how-saving-works/).

You can close the page at any time with **Done**. Saving doesn't depend on it.

### On Free with more than 10 chats

If you have more chats than Free keeps, a band below the card says so, for example "1,284 older chats aren’t saved yet", with a **Save all of them** button. Otherwise it reads "Want your whole history?" with **See Pro**. Both open the plans. This is optional; Free keeps working.

## After setup

From now on it runs on its own:

- New and changed chats are saved every 3 hours by default. Change that in [Auto-save and schedule](https://chattomarkdown.com/docs/1.0.1/schedule/).
- A chat is also saved a few seconds after you leave it.
- On every chat page, a **Save** button sits next to Share. See [The Save button and shortcut](https://chattomarkdown.com/docs/1.0.1/save-button/).

Further down the welcome page, **Import your chats** brings in a service's data export, and "Good to know" shows where things are. [A quick tour](https://chattomarkdown.com/docs/1.0.1/tour/) covers the same ground.

## If the done card says something else

| You see | What it means | What to do |
|---|---|---|
| **Nothing saved yet** | No folder chosen. | Do step 1. |
| **Saving is paused** | Chrome no longer allows the folder. | Click **Allow access** in step 1 and allow. |
| **One more step** | No service is signed in yet. | Turn on a service and sign in, in step 2. |
| **You’re all set** | Saving is on; chats will show up in a minute. | Wait, or click **Done**. |
| A service saves "only the chats you pick" | That service is set to **Only chats I save**. | Click **Save** in a chat to add it, or change it in [Chat services](https://chattomarkdown.com/docs/1.0.1/services/). |

If the first sync shows nothing for a long time, open the popup: it says what each service is doing, such as waiting because a site asked it to slow down. The [Sync log](https://chattomarkdown.com/docs/1.0.1/sync-log/) lists every chat saved or skipped and every problem. More fixes are in [Troubleshooting](https://chattomarkdown.com/docs/1.0.1/troubleshooting/).

## Questions

### I closed the welcome page. How do I get it back?

Open the extension's Settings and click Welcome tour at the bottom of the page. The toolbar popup also lists the steps left, with a Start saving button.

### Does anything get saved before I press Start saving?

No. Choosing a folder only checks that it can be written to. Automatic saving, including saving when you leave a chat, starts only after you press Start saving. A chat you save yourself with the Save button is saved right away.

### Should I pick my whole Obsidian vault or a folder inside it?

Either works. Each service gets its own folder inside the one you pick. Many people make an "AI Chats" folder in the vault and pick that, so the chats stay together.

### Do I have to pin the extension?

No. Pinning only keeps the popup one click away. Click Skip this step if you'd rather not.
