Roam Research Docs · Help & user documentation
Block References
markdown version · view in Roam Research
- One of Roam's most powerful, flagship features
- What is it?
- Every block in Roam has its own ID, unique to only that block
- When you want to refer to something, instead of copying the literal content of that block, you can copy the ID that refers to that block
- Like every page can have linkage with each other, blocks can be interconnected too
- Why is it important?
- Block references help you make every block of your notes more reusable, either by yourself in the future, or by others when the graph is shared
- This means
- Less reinvention of the wheel
- No need to copy and paste, and generate a bunch of content that means the same thing!
- Less maintenance, less confusion
- If you change the content in the original block, the references that point towards the original block will all be automatically changed, saving you time to maintain multiple copies of the same content
- More incentives for quality content creation
- The more insightful content, the more it gets referenced by yourself and others
- Ultimately, knowledge is no longer static, but becomes fluid
- You are free to open up different windows in the sidebar, Roam around and remix and rematch content from articles, people, days, and projects
- How to use it?
- You can replace block references with text, embed, alias, original or with text + alias. The most important of these is text and alias
- Example::
- from Beating the Averages
- This is a block ref
- In the summer of 1995, my friend Robert Morris and I started a startup called Viaweb. Our plan was to write software that would let end users build online stores. What was novel about this software, at the time, was that it ran on our server, using ordinary Web pages as the interface.
- It is a window onto a block from somewhere else in your Roam Graph - changes to that block will be reflected here as well.
- To make a block ref, to Create a block reference
- right click on a block
- alt-drag and drop
- If you click on a block ref you will now see the below menu:
- Jump to block and open in sidebar will do the same thing that clicking and shift-clicking (respectively) used to - they move either the focus of your main work area to that block - or open it in it's original context
- You can also do these operations with Control-o and Control-shift-o (o standing for open) respectively.
- If you select Replace With you will see the below menu:
- If you choose to replace with
embed you will get this:
- In the summer of 1995, my friend Robert Morris and I started a startup called Viaweb. Our plan was to write software that would let end users build online stores. What was novel about this software, at the time, was that it ran on our server, using ordinary Web pages as the interface.
- You can now see the refs in the right margin and the block now lives here and its original location is now holding a reference to the above block
- This is useful when you want to change the location of a block to make the references more easily accessible or where the original block makes more sense to be
- If you choose to replace with
original you will get this:
- In the summer of 1995, my friend Robert Morris and I started a startup called Viaweb. Our plan was to write software that would let end users build online stores. What was novel about this software, at the time, was that it ran on our server, using ordinary Web pages as the interface.
- You can now see the refs in the right margin and the block now lives here and its original location is now holding a reference to the above block
- This is useful when you want to change the location of a block to make the references more easily accessible or where the original block makes more sense to be
- If you choose to replace with
text you will get this:
- In the summer of 1995, my friend Robert Morris and I started a startup called Viaweb. Our plan was to write software that would let end users build online stores. What was novel about this software, at the time, was that it ran on our server, using ordinary Web pages as the interface.
- It is the same as copy-pasting the original text - there is no longer any connection between the text and the new block
- If you choose to replace with
alias you will get this:
- *
- This gives you a link to the original item - but in a hyperlinked alias
- The format for aliases is
[alias](((blockid)))
- We default to having the alias as the
* footnote symbol, but you can edit this however you feel
- This is useful if you want to point to multiple ideas, but refer to them with another phrasing - like Premise 1 and Premise 2
- you will see that if you hover over an alias you can see the text of the block you are pointing to as a preview
- If you choose to replace with text and alias you will get this:
- In the summer of 1995, my friend Robert Morris and I started a startup called Viaweb. Our plan was to write software that would let end users build online stores. What was novel about this software, at the time, was that it ran on our server, using ordinary Web pages as the interface. *
- This is useful for drafting - or making a modified version of the original text - you have an alias pointing to the source material - but the text is conveniently there for editing/rewording etc. #Writing
- Apply children
- Copying multiple block references
- Team GIFs::
- Create a block reference
- right click on a block
- alt-drag and drop
- Replace with
- text and alias
- text
- original
- no children
- with children
- Apply children
- Inline references
- Toggling and navigating
- Read status
- Community Videos::
- Quick Intro to Block References in Roam Research by Matias Faure
- Roam Research: Quick access to concepts/definitions using Links and Block References by Les Kristofs
- Articles::
- Key Commands::
