How to migrate from Org-roam v1? ​

Those coming from Org-roam v1 will do well treating v2 as entirely new software. V2 has a smaller core and fewer moving parts, while retaining the bulk of its functionality. It is recommended to read the documentation above about nodes.

It is still desirable to migrate notes collected in v1 to v2. To migrate your v1 notes to v2, use ‘M-x org-roam-migrate-wizard’. This blog post provides a good overview of what’s new in v2 and how to migrate.

Essentially, to migrate notes from v1 to v2, one must:

  1. Add IDs to all existing notes. These are located in top-level property drawers (Although note that in v2, not all files need to have IDs).
  2. Update the Org-roam database to conform to the new schema.
  3. Replace #+ROAM_KEY into the ROAM_REFS property
  4. Replace #+ROAM_ALIAS into the ROAM_ALIASES property
  5. Move #+ROAM_TAGS into the #+FILETAGS property for file-level nodes, and the ROAM_TAGS property for headline nodes
  6. Replace existing file links with ID links.