Import from Roam
Roam can export your whole graph as Markdown, and Capacities can import Markdown. Your pages, daily notes, and [[links]] come across. Block references and images need a little extra care.
For general import docs, see:
Quick migration flow
- Decide which Roam pages should become Capacities object types.
- Create those object types in Capacities.
- Export your graph from Roam as Markdown, and export your attachments.
- Import in the Capacities desktop app.
- Check the results, then fix block references and images.
Warnings
- Bulk Import runs in the Capacities desktop app, not in the browser
- Capacities allows one daily note per day. If a day already has a daily note in Capacities, the Roam daily note for that day is skipped
- Do not continue if the mapping looks wrong
Understand the paradigm shift
In Roam, every page is the same kind of thing, and you give it structure with tags and attributes. In Capacities, every note has a type, like a Person, a Book, or a Meeting, and the type decides its properties.
Your import will be cleaner if you decide what your pages are before you start. If you want a deeper explanation of this shift, read Understanding the paradigm shift.
How Roam organizes your content
| Roam | What it is |
|---|---|
| Page | A note, made of nested blocks |
| Daily Notes | A page for each day |
[[link]] or #tag | A link to another page, shown in that page's Linked References |
| Block reference | A link to a single block, written as ((block-id)) |
| Attribute | A line like Author:: Mary Oliver that adds a value to a page |
| Query | A live list of blocks that match a search |
Translate to Capacities
In Roam, a page often turns into a kind of thing because you tag it, for example with #Book or Type:: Book. In Capacities, make that a real Book type, and turn its attributes into properties.
| Roam | Capacities | Notes |
|---|---|---|
| Page | Object | A Page, or a type like Book or Person |
| Tag or attribute that names a kind of thing | Object type | Turn other attributes into properties |
| Tag for a topic | Tag or a linked object | |
| Daily Notes | Daily notes | |
[[link]] | Object link | Links come across in the import |
| Block reference | Block reference | Re-link by hand |
| Query | Query (Pro) | Rebuild by hand |
roam/templates | Templates | Rebuild by hand |
Before you export
Create your object types in Capacities first, with the properties you want to keep.
If you have already started writing daily notes in Capacities, check for days that overlap with Roam. Capacities keeps one daily note per day, so the Roam daily note for that day will be skipped. Copy those days in by hand after the import.
Export from Roam
- In Roam, open the ⋯ menu at the top right and choose Export All.
- Pick Markdown and download the file.
- Unzip it. You get one Markdown file for each page.
- To keep your images and other uploads, go to Settings > Data & Backups and choose Export attachments. This needs the Roam desktop app, Chrome, or Edge.
Daily notes are named with Roam's dates, for example February 2nd, 2021.md. Images in the Markdown still point to Roam's online storage, which is why it is worth exporting your attachments as well.
Import into Capacities
In the Capacities desktop app, go to Settings > Import Content and click Start importing in the Bulk import section. Upload the folder of Markdown files.
Before you import:
- Turn on Daily Notes > Identify by filename, so your Roam daily notes become Capacities daily notes
- Check that each page is going to the right object type
- Optionally add an import marker so you can find everything later
Then click Analyze, review, and click Import. Keep Capacities open until the import is done.
After the import
Check:
- Titles and object types
- Daily notes, especially any days that were skipped
- Links between notes
- Images
- Attribute lines like
Author:: Mary Oliver, and whether you want to move their values into properties
Block references
Roam block references come across as codes like ((abc123)), which only mean something inside Roam. Search your space for (( to find them, then link the block again with a Capacities block reference.
Queries and templates
Roam queries and templates do not import. Rebuild the ones you still use as Capacities queries and templates.
Ask a question! - The Docs Assistant knows everything about the documentation, and the ideas and feature requests from other users.
Create a ticket on our feedback board. - Let us know if you have an idea for a feature, improvement or think there is something missing.
Request additions to the documentation. - If your questions are not getting answered, let us know and we will extend the documentation.