You're reading the docs for 1.0.1. The latest version is 1.0.5. Read this page for 1.0.5

Set up in two minutes

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.

View as Markdown

In short

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.

On this page
  1. Step 1: Choose a folder
  2. Choosing your Obsidian vault
  3. Save images and files
  4. If the folder step fails
  5. Step 2: Turn on the AI services you use
  6. Step 3: Pin it to your toolbar
  7. Start saving
  8. What the first sync does
  9. On Free with more than 10 chats
  10. After setup
  11. If the done card says something else
  12. Questions

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 stepsThe welcome page with the setup steps
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 pageThe setup block on the welcome page
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 VaultThe folder step after choosing a folder named Obsidian Vault
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.
  • 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 and Choose your 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.

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 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 onThe list of chat services with buttons to turn them on
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 showsWhat it meansWhat to do
Signed inReady to save.Nothing.
Not signed inYou 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 checkThe 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.

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.

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 buttonThe Ready to save your chats card with the Start saving button
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. 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 runsThe card while the first sync runs
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.

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.
  • 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.

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:

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 covers the same ground.

If the done card says something else

You seeWhat it meansWhat to do
Nothing saved yetNo folder chosen.Do step 1.
Saving is pausedChrome no longer allows the folder.Click Allow access in step 1 and allow.
One more stepNo service is signed in yet.Turn on a service and sign in, in step 2.
You’re all setSaving 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.

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 lists every chat saved or skipped and every problem. More fixes are in 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.

↑↓ to move ↵ to open Esc to close