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

  1. Decide which Roam pages should become Capacities object types.
  2. Create those object types in Capacities.
  3. Export your graph from Roam as Markdown, and export your attachments.
  4. Import in the Capacities desktop app.
  5. 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

RoamWhat it is
PageA note, made of nested blocks
Daily NotesA page for each day
[[link]] or #tagA link to another page, shown in that page's Linked References
Block referenceA link to a single block, written as ((block-id))
AttributeA line like Author:: Mary Oliver that adds a value to a page
QueryA 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.

RoamCapacitiesNotes
PageObjectA Page, or a type like Book or Person
Tag or attribute that names a kind of thingObject typeTurn other attributes into properties
Tag for a topicTag or a linked object
Daily NotesDaily notes
[[link]]Object linkLinks come across in the import
Block referenceBlock referenceRe-link by hand
QueryQuery (Pro)Rebuild by hand
roam/templatesTemplatesRebuild 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

  1. In Roam, open the ⋯ menu at the top right and choose Export All.
  2. Pick Markdown and download the file.
  3. Unzip it. You get one Markdown file for each page.
  4. 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.

Are you missing something in the documentation?

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.