Skip to content

Initial thinking on Roam to WordPress Plugin

What I’m trying to do with this plugin is to create a digital garden that I can connect from Roam Research to WordPress.

Most of the existing solutions are using static web site generators. I’d like to avoid that because I want to have only one CMS on my site and to also maintain only one theme. There are also additional potential power features that would allow me toI can connect exported Roam pages to WordPress Taxonomies.

My current thinking is as follows:

When looking at the overall architecture design I realised that:

  • Roam’s JSON API is something that I don’t understand, it’s undocumented and hard to develop. So I’ll pass it for now.
  • Exported MD files are nice but they’re messy to automate.
  • Uploading one exported JSON file allows me keep all application logic in WordPress plugin and removes the need for any additional tools.

I’ve also found some nice prior art. There’s WP Roam Blocks that does something similar within Gutenberg.

I also appreciate blogging from David Bieber where he describes how he’s currently using Python to blog with Roam:

Next steps

  1. REST API to allow uploading of Roam’s JSON export
  2. Initial React backend upload dialog
  3. Basic jsonq parsing of uploaded JSON file