Your Knowledge System Is Useless Without Metadata

Building out your Knowledge System with Roam Research Metadata

Andrew Crider
Apr 25 · 4 min read
Photo by <a href=”https://unsplash.com/@elisa_cb?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText">Elisa Calvet B.</a> on <a href=”https://unsplash.com/s/photos/knowledge?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText">Unsplash</a>
Photo by Elisa Calvet B. on Unsplash

Over the past year, Knowledge workers have become increasingly isolated. With Zoom calls, remote meetings, and work from home, it becomes harder to retain context with what we are working on because of the uniformity of our current work environment. How do we build this context in our Knowledge System?

I have become ever more dependent on notes, task lists, and online research to meet my work needs. I have created a personal knowledge system with Roam Research. To date, my graph has:

My Roam Research Stats to Date
  • 868 Pages
  • 120,178 Words
  • 3,865 Connections
  • 1,129 Links

But is creation enough? How much of this research are just in-the-moment thoughts that are never revisited? Are we retaining our learnings? I’m able to surface things that I need when I search my graph, like this article:

The author, Eva Keiffenheim, MSc, makes the following point:

I’ve noticed a recurring pattern: it’s less important what kind of brain you have — what matters is how you use it.

The first step that we need to make is how to retrieve the information that we have gathered. Enter metadata.

Metadata is data that describes our data

Before we can begin to resurface data, we have to know what the data is about. Enter Roam Research. Roam Research, at its core, is based on Pages or Topics. These pages help you organize your thoughts, and you can create bi-directional links between pages to make connections. I use Pages, Attributes, and Tags to identify the metadata associated with each block.

  • [[Pages]] — Used for Overall Topics
  • Attributes:: — Used for tracking items or creating a table based on metadata
  • #Tags — I use these to create items that I want to remember or otherwise find within my database — I use these often to indicate items that I want to query for in Roam Research but aren’t necessarily part of an overall topic

Research Metadata in Roam Research

Every time I read an article, I take notes in Roam Research. Using templates, I type ‘;;’ and up comes my Read Articles template.

My Template for Articles to Read
  • Link to the Article (with the #unread tag)
  • author:: [[Author Name]] An attribute so that I can find all of the authors that I have read and I create a new page for the author — this Allows me to group all of an author’s articles.
  • tags: This allows me to develop bi-directional links to multiple topics
  • thoughts: Here, I either copy and paste from the article, add my thoughts and musings and connect to other things that I have read.

Let’s look at one entry from the article above. You’ll notice that the quotes from the article are italicized (sometimes I use the tag #quote) to distinguish between my thoughts and the authors. Things that I want to remember are tagged with #surface. I also change my tag to #read so that I can track when I have completed consuming an article.

My notes from Evidence-Based Strategies to Better Remember What You Learn

If you’re interested in Scraping multiple articles for your research, check out this post on using Python to get articles from the web.

Human Connections are critical

As a consultant, I have worked on many different projects with many people. Being able to retain connections (or at least be able to remember who they are) is critical. Thus my People CRM was born. I use Roam Research to connect topics, projects, and clients within my graph. Here’s an example of the metadata that I create for each one of my connections to add people to my knowledge system. When I start traveling again, I also know where people are so that I can visit them!

An entry in People CRM

Utilizing your Knowledge System

You’ve taken the first step to wrangling your Knowledge System. By applying metadata throughout your notes, you can now easily search for items with Roam Research, create queries to corral your thoughts, and flag things you want to follow up on. With Roam Research, you could even make a shared graph for your Scrum Team or Department to share these connections.

Check out some templates for your metadata here on GitHub.

In our upcoming articles on Building your Second Brain, we will use this metadata to tie all of your tools together.

  • Connect your Todo List to your Roam Research Pages
  • Surface information about your clients before you have meetings with them
  • Surface Research when you start a new Project
  • Build over Turn Over Documents with Context and Lessons Learned

For your personal use, you may want to import your personal readings or viewing history. To find out more check out this follow up article:

If you want to create your own Second Brain, please join our mailing list for periodic articles!

Originally published at https://recursiveautomation.com on April 25, 2021.

Sign up for Geek Culture Hits

By Geek Culture

Subscribe to receive top 10 most read stories of Geek Culture — delivered straight into your inbox, once a week. Take a look.

By signing up, you will create a Medium account if you don’t already have one. Review our Privacy Policy for more information about our privacy practices.

Check your inbox
Medium sent you an email at to complete your subscription.

Andrew Crider

Written by

Head of Digital Transformation at Provoke Solutions (www.provokesolutions.com) Blogger at recursiveautomatoin.com

Geek Culture

A new tech publication by Start it up (https://medium.com/swlh).

Andrew Crider

Written by

Head of Digital Transformation at Provoke Solutions (www.provokesolutions.com) Blogger at recursiveautomatoin.com

Geek Culture

A new tech publication by Start it up (https://medium.com/swlh).

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store