
## Preface

Back in 2021, I started using Roam Research (which I'll refer to as Roam) as my notetaking tool. In a previous article titled "Why I Use Roam," I detailed the reasons behind this decision. In recent years, a host of new notetaking software has exploded onto the scene. This trend has sparked interest in different notetaking methods. Therefore, choosing a notetaking tool means choosing a notetaking method.

So, how can Roam or similar software be used for academic research? There are plenty of articles out there on how to use Roam, with most focusing on the card note-taking method, which emphasizes the individuality and reusability of notes. However, fews focus on using Roam for academic research. In this article, I aim to share my experience of using Roam for academic research, from notetaking through to writing articles. The key doesn't lie in mastering the card notetaking method but in developing a suitable note framework based on one's own research practices to closely connect notetaking with research activities.

## Key Concept: Two-Stage Notetaking

Initially, notes serve to consolidate our reading and reflection. Eventually however, the notes themselves warrant further exploration, reevaluation and organization, to generate newer notes. Consequently, notetaking typically involves two stages, which I call Stage A and Stage B.

Stage A notes are the raw notes, which could be literature excerpts, reflections, or even an image or a link. In my case, Stage A notes primarily consist of literature reading notes.

Stage B notes are refined notes, representing a secondary process where notes are taken on the raw notes. In my case, I extract specific concepts or issues based on the literature reading notes or establish links between different Stage A notes.

Put simply, during academic research, I first read numerous pieces of literature and take notes. Then, based on these literature notes, I extract relevant concepts or issues for further exploration. This is a common practice across any note-taking tool, including traditional paper notes. However, Roam has improved the efficiency and elegance of this process.

## Research Practices: Three Projects

Before I started using Roam, I spent a week designing a note framework tailored to my own learning and research practices. The essential point here is that **you should establish a note framework according to your own studying or researching pracrices**. My personal research pracrices involves regular in-depth reading of literature, reflecting on and organizing the literature, drafting fragmented thoughts, and eventually writing.

My research zeroes in on the philosophy of law, a category of humanities theoretical research. If you're familiar with theoretical research in humanities, you'll know that **texts**, **authors**, and **concepts** are three fundamental pillars of any research in humanities. Philosophical and social science theories deal with these three basic projects every day. What exactly does a classic text convey? What are the thoughts of a classic author on a concept? How should a classic concept be understood? Moreover, these three pillars are intertwined: the thoughts in a classic text revolve around particularly important concepts, and the ideas of a classic author undoubtedly involve a certain classic text and the concepts it expounds. Different authors discuss the same concepts, and so on.

Before the introduction of Roam, organizing notes around these three pillars was neither very convenient nor elegant. For instance, using traditional notetaking software meant creating many documents or pages, with linking them together for two-stage notetaking proving complex.

However, Roam solved these issuess with ease. Each note in Roam is essentially a webpage, making referencing between them as simple as creating a link. Roam even displays the links established between them. Therefore, Roam has considerably improved the convenience, efficiency, and elegance of conducting research, particularly in humanity fields.

## Note Framework

Once the research practices are clear, the note framework can be designed accordingly. Start by creating several root projects (or if you prefer, "nodes" or "pages"), namely "Texts," "Authors," and "Concepts." These three projects can serve as both Stage A and Stage B notes.

![Note Framework](/images/2024-01-06/KWK0v8zw8m.png)

Roam advocates often mention that you don't need to care about the tree-like relationships or hierarchies between notes. Generally, this is correct. However, it's still necessary to establish some root note projects. This is not only related to the form of note organization but also involves the essence of research practices. Roam precisely combines the form of note organization with the essence of research practices. (Of course, in my case, I also established some transactional root projects outside of core research, such as "Issues," "Submissions," "Projects," "Interests," etc. Since these are not the core issues, I won't mention them further below.)

These root projects are typically fixed on the left sidebar of Roam. Their content is not determined all at once but changes over time. My daily note-taking process is as follows:

- Add new projects in "Texts," typically are literature that is being read or awaiting reading.

- Make reading notes within these texts projects. These projects constitute Stage A notes.

- At a future specific time, read Stage A notes, and open or create new projects on the right sidebar. For example, while researching Stage A notes and wanting to summarize key points or issues about a particular figure, whether it's the author of the current text or related authors. You can also create entries for related concepts or issues. These entries will be opened on the right sidebar.

Here's an example. As shown in the image below, the entry "Taking Rights Seriously" (《认真对待权利》authored by Dworkin) is one of my Stage A notes. When writing to a certain extent or at a specific time, I may create or open the "Dworkin"（德沃金） project on the right sidebar and then extract, organize, or summarize certain key points.

![A example](/images/2024-01-06/xd0PCAZ4V9.png)

You may notice that each node within the "Dworkin" project starts with a "daily notes" node and a simple title. This is because the information we have about a author, concept, or issue, as well as the thoughts we develop based on it, are not complete or final. They undergo a process of addition, deletion, and revision. Therefore, leaving a timestamp for Stage B notes can reflect this real process. Additionally, at different times, we may contemplate and organize the same or similar issues. For example, in March of last year, I contemplated Dworkin's views on the issues of the individualization principle of rules, based on the Stage A note "Taking Rights Seriously," and in October of this year, I may contemplate this issues or a similar one again. Still, there's no need to go through the "Dworkin" entry, as I can directly write a new entry. The note-taking software will record and display possible connections between them. When further organizing in the future, we can also compare thoughts from different periods.

Furthermore, notes on different issues may be taken at different times. For example, on February 2, 2022, I may have researched both Dworkin's views on the issues of the individualization principle of rules and read Raz's "The Concept of the Legal System," which involves this issues. At the same time, I may have checked H.L.A Hart's views in "The Concept of Law," or many other issues. These issues may generate Stage B notes, and when each entry has a timestamp, opening the corresponding daily note link in the future can provide an aggregation of what research we did at some time, which is likely highly relevant.

![A example](/images/2024-01-06/-DwMJuhOmH.png)

In summary, Stage B notes involve the extraction, organization, and expansion of Stage A notes, and it's not a one-time process. Over time, the information we have about related issues and the thinking process will change. Roam helps us reflect this process.

It can be seen that literature notes in the root project "Texts" are usually Stage A notes, while notes in the root projects "Authors," "Concepts," or "Issues" are usually Stage B notes. One small trick is that during the process of creating a concept list, if entering a concept in "[[]]" doesn't prompt a selection, then it's a new concept. In this case, it needs to be added to "Concepts." Also, for added convenience in adding and retrieving, both "Authors" and "Concepts" are organized in order of letters in an alphabet. The concept list aims to be concise, and maintaining such a list may not seem useful in daily, but it's a process of building one's own knowledge system and network.

## From Notes to Writing

We already have two stages of notes. Stage A notes are generally used for the material of Stage B notes (we may also reference Stage A notes extensively in Roam's Stage B notes), and they can also be used as material for future writing. Meanwhile, Stage B is mainly used for future thinking and writing. For example, we may already have a lot of content for the "Recognition Rules" in Stage B notes. If you want to research this concept, you can open this project and explore all the Stage A or Stage B notes associated with it.

**How to realize the process from notes to writing in Roam**? The key is to do a good job with the two stages of notes. The better you do with Stage B notes, the more convenient your future writing will be. In my case, I often write many lengthy thoughts in Stage B. Sometimes in the process of taking notes, some ideas are very novel or deep for a certain issues, and unconsciously, I write a lot. So, I simply create a new writing project in the "Projects" root directory and expand it into a blog post, even into an academic paper.

Here, the key is not the so-called card note-takeing method. All you need to understand is that according to such a designed note framework, **Stage B notes are not only able to connect with Stage A notes and other Stage B notes, but also can be repeatedly used, arranged or modified in future note-taking and writing**. If you want to call these Stage B notes "card notes" or "permanent notes", there's no problem.

## Technical Issue: Writing Papers on Roam

Many people believe that Roam is only suitable for note-taking and drafting short articles. How do we go about it if we want to write a paper in Roam? Can Roam's outline editor handle this task? Yes. Over the past years, from writing few paragraphs to writing blogs and papers, I have done all on Roam.

Firstly, for writing with simple formatting requirements, Roam can export any node as a Flat Markdown document. For those who rely on the outline editor to think and write **more** orderly, writing on Roam is a vital need. Of course, if you don't have such dependence, the rest of this section is unnecessary to read.

Secondly, Roam still can handle writing with complex formatting requirements, but with the help of **LaTex**. LaTex fits any text editor, including Roam's outline editor. With appropriate markings, LaTex can generate a paper with complete format upon compilation.

Common LaTex markings are "\footnote{}", "\textbf{}", and "\textit{}". For images, lists, or tables, I suggest leaving corresponding markers when editing on Roam, and adding them later in the specialized LaTex editor. On Roam, you only need to write the main text and don't need to add full LaTex markings. Using the template feature Roam provides, you can easily call up commonly used LaTex markings, as shown in the figure below.

![LeTex o Roam](/images/2024-01-06/7nfeNEAjbV.png)

In this way, write the main part of the paper in Roam, along with necessary LaTex markings. When finished, export it as a Flat Markdown document and continue to edit in a specialized LaTeX editor.

Maybe your tutor asks you to submit a Word document for review. A convenient way to convert Tex documents to Word documents is required. [Pandoc](https://pandoc.org/) offers can heplp you. Firstly, use Pandoc to prepare a Word document template and then use Mricosoft Word program to adjust the formatting of this document template to the format required for the paper. Then, use Pandoc commands to convert the Tex document to a Word document. Since it is not for official paper submissions, Word templates don't need to perfectly match the paper formatting requirements. Of course, theoretically, Tex documents can be converted directly to Word documents without further formatting adjustments, as long as you're willing to spend enough time adjusting the templates and Pandoc commands. This technical detail is not the main topic of this article, and I will elaborate it in another article if possible.

## Summary

This article outlines how to do academic research on Roam, using the author's own study and research practices as examples:

First, the basic issues of note-taking should be established: two-stage notes should be created, and the initial notes should be organized and digested for further thinking and writing in the future.

Second, establish a note-taking framework in accordance with your specific study and research practices. The note-taking framework is the basic root directory on the basis of which all notes are organized, and the process is also a research process.

Third, by taking good two-stage notes, you will be able to realize the process from notes to writing.

Finally, in order to be able to complete the research and writing process on Roam for complex issuess, other technological tools such as LaTex, Pandoc are needed.

In conclusion, we should establish a note-taking framework, take good two-stage notes, and use the notes for writing based on a clear understanding of our own learning and research practices.


This article, using the author's own learning and research practices as an example, provides a brief overview of how to conduct academic research on Roam. The key points emphasize establishing a note framework based on one's specific learning and research practices, implementing a two-stage note-taking process, and utilizing these notes for writing.

How to use Roam Research for academic research?


## 前言

我在 2021 年将 Roam Research （以下简称 Roam）作为我的笔记工具。早在《[我为什么使用 Roam](/blog/why-roam-research) ？》中，我讲述了选择这款笔记软件的缘由。这几年新型笔记软件如同雨后春笋般涌现。新型笔记软件的兴起也激发了人们对某些笔记方法的兴趣。可以说，选择一种笔记软件，意味着选择一种笔记方法。

那么，如何用 Roam 或 Roam 类笔记软做学术研究呢？介绍如何使用 Roam 的文章不少，很多是围绕卡片笔记法的。它们强调了笔记的原子化和复用性。不过，至今还没有看到介绍如何用 Roam 做学术研究的。在这篇文章中，我将介绍我是如何用 Roam 来开展学术研究的——从记笔记到写文章，都在 Roam 上进行。实现这个目标的关键问题不是如何做好卡片笔记法，而是根据自己具体的研究实践建立恰当的笔记框架，将记笔记和研究实践紧密联系起来。希望这篇文章对于那些还对如何利用 Roam 类笔记软件来学习和研究的人有所启发。

## 基本问题：两阶段笔记

笔记本来是对阅读和思考的整理，但笔记本身还需要再次被阅读和思考，并整理出新的笔记。这就决定了，笔记至少要分两个阶段，我分别称之为 A 阶段和 B 阶段。

A 阶段笔记是原始笔记，它可以是文献摘抄、随想、阅读札记甚至只是一张图片、一个链接。就我个人而言，我的 A 阶段笔记主要是文献的阅读札记。

B 阶段笔记是二次笔记，它是对笔记的加工，是笔记的笔记。就我的实践而言，我会在文献的阅读札记的基础上提取某些概念、问题，或者在不同的 A 阶段笔记之间创造联系。

简单说，在学术研究的过程中，会阅读许多文献，这需要记笔记，然后在文献笔记的基础上提取相关的概念或问题进一步研究。其实，在任何笔记工具上，包括过去的纸质笔记，都有这个过程，但是 Roam 的出现，使得这个过程变得异常高效、优雅。

## 研究实践：三个项目

在使用 Roam 之前，我用了一个星期的时间为其设计一个笔记框架。关键的一点是，**应当依照自己具体的学习或研究实践来建立恰当的笔记框架**。我个人的研究实践是这样的：平时阅读文献（而且主要是精读），然后思考和整理文献，然后撰写思想片段，最后用于写作。

我做的法哲学研究，属于文科思想理论研究的一种。熟悉思想理论研究的都知道，文献、作家（者）、概念是三个基本研究项目。哲学社会科学理论每天都跟这三个基本项目打交道。一本经典文献到底讲了什么？一个经典作家在某个问题上的思想到底是怎样的？一个经典概念到底应该如何理解？不但如此，三个项目还相互交织：经典文本的思想必定围绕特别重要的概念进行，而某个经典作家的思想肯定涉及某个经典本文及其所阐发的某些概念，不同的作家谈论相同的概念或问题，如此等等。文献、作家和概念是开展思想理论研究的三个把手，所有的阅读、思考、笔记和写作都是围绕它们进行的。

在 Roam 出现之前，把三个项目作为基础来组织笔记，并不便利，也难说优雅。比如，使用最传统的笔记软件——记事本、备忘录或 Word 文档，需要建立许多文档或页面，但是将它们联系在一起，做两阶段笔记，就不那么容易。比如，假如用 Word 记笔记，建立一个文档 A，记录文献阅读笔记 ，然后，建立另一个文档 B，整理笔记 A 中的某些概念或问题。很难在 B 中引用或提及 A ，即使这样做了，要建立链接也不那么高效或优雅。

在 Roam 出现之后 ，任何笔记实际上就是一个网页。在 A 笔记中提及或引用 B 笔记（或其一部分），所需要做的只是建立一个链接。并且， Roam 还会展示它们之间建立的链接。可以说，Roam 使思想理论研究（特别是文科的），变得比以往任何时候都更加便利、高效和优雅，简直可以说是一种享受。

## 笔记框架

明确自己研究实践之后，笔记框架就能够被设计出来。首先建立几个根项目（或者你愿意，“节点”或“页面”），它们分别是“文本”、“人物”、“概念”。（在下面的实例展示中，我使用的是英文。）这三个项目既可以是 A 阶段笔记，也可以是 B 阶段笔记。

![笔记框架](/images/2024-01-06/KWK0v8zw8m.png)

Roam 的倡导者都提到，使用 Roam 不必在乎笔记之间的树状关系或层次。一般而言这是正确的。不过，还是有必要建立一些根笔记项目。这不仅事关笔记组织的形式问题，也涉及研究实践的实质问题。Roam 正是使笔记组织的形式和研究实践的实质密切结合在一起的工具。（当然，在我的实例中，还建立了一些核心研究之外的事务性根项目，如“问题”、“投稿”、“项目”、“兴趣”等。由于这不是核心问题，下面就不再提及它们了。）

这些根项目一般固定在 Roam 的左侧边栏。它们的内容不是一次性确定的，而是随着时间的推移而变化。我日常记笔记过程是这样的：

- 在“文本”中添加新的项目，这些项目一般是某个在读或待读的文献。

- 在这些文献项目内做阅读札记。以上就是所谓 A 阶段笔记。

- 在未来的特定时间，阅读 A 阶段笔记，在右侧边栏打开或建立某些新项目。比如，研究 A 阶段笔记，想要总结有关人物的思想要点或问题，该人物可以是当前文本的作者，也可以相关的作家。也可以建立相关概念或问题的条目。这些条目将在右侧边栏打开。

举一个实例。如下图所示，“认真对待权利”（它的作者是德沃金）这个条目是我的一个 A 阶段笔记。当撰写到一定程度，或是在特定的时间，我可能会在右侧边栏新建或打开“德沃金”这个项目，然后提取、整理或概括出某些要点。

![一个示例](/images/2024-01-06/xd0PCAZ4V9.png)

您可能会注意到，“德沃金”项目内的每一个节点都以“daily notes”项目开始，并加上一个简单的标题。这是因为，我们对某个人物、概念或问题所掌握的资料以及凭此开展的思考都不是完整的、最终的，而是经历一个增加、删减、修正的过程。因此，为 B 阶段笔记留下时间印记，能够反映这个真实过程。此外，在不同的时间，我们可能思考和整理相同或相似的问题。比如，去年3月份，我思考“德沃金对规则的个别化原则问题的观点”，依照的 A 阶段笔记是 “认真对待权利”的，而在今年10月份，我再次思考这个问题或相似的问题，但不必翻遍“德沃金”条目，而是可以直接写下新的条目。笔记软件会为我们记录和展示它们之间可能的联系。将来更进一步整理时，也能将不同时期的想法做对照。

此外，在某个特定时间会做不同问题的笔记。比如，2022年2月2日，我可能既研究了“德沃金关对规则的个别化原则问题的观点”，也看了拉兹的《法律体系的概念》，而这本书里涉及这个问题，同时也看了哈特在《法律的概念》中的某些观点，或者还有其他许多问题。这些问题都可能会产生一些 B 阶段笔记，当每个条目都加入时间戳，未来打开相应的时间页面链接，就能获得一个聚合。这有利于我们日后看到，在特定时间，我们做了哪些研究，而这些研究很可能是高度相关的。

![一个示例](/images/2024-01-06/-DwMJuhOmH.png)

总之，B 阶段笔记是对 A 阶段笔记的提取、整理和拓展，并且不是一蹴而就的。随着时间的推移，我们对相关问题所掌握的资料和开展思考会发生变化。 Roam 帮助我们便利地反映这个过程。

可以看到， 根项目“文本”中的文献笔记通常是 A 阶段笔记，而根项目“人物”、“概念”或“问题”中内的笔记通常是 B 阶段笔记。有一个小技巧是，在建立概念清单的过程中，如果在“[[]]”中输入某个概念没有提示选择，那么就是一个新的概念，如此需要在“概念”中添加。此外，为了添加和检索便利，“人物”和“概念”都按拼音顺序组织。概念列表务求精要，维护这样一个列表虽然日常不会感到有什么作用，但却是一个建立自己的知识体系和网络的过程。

## 从笔记到写作

我们已经有了两阶段笔记。A 阶段笔记一般用于 B 阶段笔记的资料（你会在 Roam 的 B 阶段笔记中大量引用 A 阶段笔记），同时可以用于将来写作的引用资料。而 B 阶段主要用于将来的思考和写作。可能我们已经有了许多“承认规则”这个B 阶段笔记项目的内容，假如想要研究这个概念，就可以打开这个项目，并探索与之发生联系的所有 A 阶段或 B 阶段的笔记。

如何实现在 Roam 中从笔记到写作的过程呢？关键是，做好两阶段笔记。B 阶段笔记做的越好，未来的写作就越便利。就我的实践而言，我常常在 B 阶段中写下许多长篇的思考。有时候在做笔记的过程中，对某个问题的想法很有新意或深度，不知不觉就写了很多，于是索性在“项目”根目录里新建一个写作项目，将其扩展为一篇博客文章，甚至是一篇学术论文。

在这里，关键的问题不是所谓卡片笔记法。只需要明白，按照如此设计的笔记框架，B 阶段笔记，能够不但与 A 阶段和其他 B 阶段笔记相联系，而且能够在今后进一步的笔记和写作中，被反复利用、整理或修改。如果您愿意将这些 B 阶段笔记叫做“卡片笔记”或者“永久笔记”，也没什么问题。

## 技术问题：在 Roam 上写论文

许多人都认为 Roam 只适合记笔记，顶多再用来写点短文的草稿。如果我们就是想要在 Roam 上写论文，该怎么做呢？ Roam 的大纲编辑器能够胜任这个工作吗？能。在过去的几年，小到写一两段文字，大到写博文、写论文，我都是在 Roam 上完成的。

首先，对于格式要求简单的写作而言，Roam 可以将任何节点导出为 Flat Markdown 文档。对于那些依赖大纲编辑器来**更**有条理地思考和写作的人来说，在 Roam 上写作是很重要的需求。当然，如果您没有这样的依赖，那么这一节其余部分也没有必要阅读了。

其次，对于格式要求复杂的写作而言，Roam 依然能够胜任。不过要借助 LaTex。LaTex 适应任何文字编辑器，包括 Roam 的大纲编辑器。只要有适当的标记，在编译时，LaTex 就能生成一篇格式完备的论文。

常用的 LaTex 标记是“\footnote{}”、“\textbf{}”和“\textit{}”。至于图片、列表或表格，我建议在 Roam 编辑时留下相应的标记，待到 Latex 专门编辑器中再添加。在 Roam 只需要撰写主体部分，没有必要在其中添加完整的 LaTex 标记。可以利用 Roam 提供的模板功能，轻松调用常用的 LaTex 标记，比如下图。

![Roam 上的 LaTex](/images/2024-01-06/7nfeNEAjbV.png)

这样，在 Roam 中撰写论文的主体部分，加上必要的 LaTex 标记。当完成之后，将其导出为 Flat Markdown 文档，然后在专门的 LaTex 编辑器中继续编辑。

就国内的环境而言，或许你的导师指定你发 Word 文档给她审阅。为此需要便捷的方式将 Tex 文档转变为 Word 文档。 [Pandoc](https://pandoc.org/) 提供的文档格式转换技术可以实现这点。首先用 Pandoc 准备一个目标 Word 文档模版，然后用 Word 将这个文档模板内的格式调整为论文要求的格式。然后就是利用 Pandoc 命令来将 Tex 文档转换为 Word 文档。由于并不用于正式的论文提交，Word 模板不要完美匹配论文格式要求。当然，只要愿意花费足够的时间调整模板以及 Pandoc 的命令，理论上，Tex 文档可以一劳永逸地完美转换为 Word 文档，并且无需再做过多格式调整。这个技术细节不是本文的主题，如果有机会，会另文详细介绍。

## 总结

这篇文章以作者自己的学习和研究实践为例，简要介绍了如何在 Roam 上做学术研究：

第一，确立记笔记的基本问题：应当建立两阶段笔记，要对初次笔记进行整理和消化，以用于将来进一步的思考和写作。

第二，依照自己具体的学习和研究实践建立笔记框架。笔记框架是基本的根目录，所有的笔记在它们的基础上组织，同时这个过程也是研究的过程。

第三，做好两阶段笔记，就能够实现从笔记到写作的过程。

最后，为了能够在 Roam 上完成复杂问题的研究和写作过程，需要借助其他技术工具，比如 LaTex、Pandoc。

总之，我们应当在明确自己的学习和研究实践的基础上，建立笔记框架，做好两阶段笔记，并将笔记用于写作。


这篇文章以作者自己的学习和研究实践为例，简要介绍了如何在 Roam 上做学术研究。关键的要点是，在明确自己的学习和研究实践的基础上，建立笔记框架，做好两阶段笔记，并将笔记用于写作。

如何在 Roam Research 做学术研究：一个实例


## 前言

这几年新型笔记软件在互联网上掀起了不大不小的涟漪。新型笔记软件仍然是小众事物。在大多数人那里，OneNote、印象笔记甚至 Word 仍然是他们对笔记软件的一般设想。新型笔记软件的实质是一种新型电子玩具。折腾新型笔记软件，就像沉迷电子游戏一样，无非是换一种娱乐方式。

过去几年我选择了 Roam Research（以下简称 Roam ），甚至在上面完成了我的博士论文的全文撰写。不过，今天我不得不重新考虑这件事。和博客一样，折腾笔记软件浪费了我大量的时间，甚至可以说耽误了我的学业。如今，我又沉溺于电子游戏。笔记软件、博客和电子游戏，真是互联网三大电子玩具，我一个也没落下。在这个过程中，我有许多故事可以分享。现在，我希望做一个有关笔记软件选择问题的终章。

在这篇文章中，依照我对记笔记这件事的本质的理解，我将逐个点评各类新型笔记软件，并且给出选择它们的建议。当然，文章的重点不在于详细介绍和对比各类软件的特性。

## 两个最重要的问题

笔记是我们最重要的资产之一。持久性问题是选择笔记软件需要考虑的核心问题。选择一种笔记软件，等于选择某种记笔记的方式，加上技术上的原因，不要期待将来可以无损迁移数据，所以必须慎之又慎。我们必须考虑，十年之后，我们的笔记将何去何从。新型笔记软件之间不可能做到无损迁移。为了尽可能保证较好的可迁移性，尽可能选择纯文本形式保存的笔记软件，以确保将来的笔记能够被正常读取和搜索。

还有一个问题值得考虑，那就是利用 AI 技术的可能性。两年前，我曾经在 Reddit 看到有人评论，Roam 的前途取决于其对 AI 技术的利用。当时我不以为意。自己记录和整理的笔记，为何要依赖 AI ？然而 chatGPT 的出现，改变了我的想法。未来一两年，没有 AI 技术加持的笔记软件，将会被淘汰。将来，笔记软件要么自带要么允许用户自行接入某种 AI 模型。比如，用户可以在自己的电脑上安装某种 LLM ，读取和分析自己的笔记数据，实现与 AI 模型对话的能力。随着笔记数据的膨胀，以及 AI 模型的改进，计算机在某些方面比我们自己的大脑还会处理我们的笔记，是显而易见的。

## Roam Research

目前，我的主力笔记软件仍是 Roam 。不过，经过几年的使用和思考，我决定放弃它。

如今看来，Roam可能是最不长远的新型笔记软件。它已经进入了小修小补的维护阶段。无论是开发者还是用户，都对这款软件失去了曾经的狂热。可以看到许多寻找 Roam 替代品的帖子。考虑到其昂贵的价格、乏善的交流渠道、与日俱增的竞争对手，这款笔记软件很难走得长远。

我用Roam写完了自己的博士论文（将来可能会介绍一下[^1]）。Roam 最重要的优点，在我看来，有如下几个方面：

- **大纲编辑器**。这对于有条理的梳理和写作是相当重要的。相信我，就笔记软件而言，认识了大纲编辑器，就不要回到平文本编辑器了。此外，Roam 的编辑器性能非常好。

- **导出功能**。用大纲编辑器撰写的文章，可以轻松导出普通的 Markdown 文件，用于其他用途。与之相比，Logseq 尽管可以导出平 Markdown 文本，但在行与行之间缺乏空行，导致其所导出的文本在普通 Markdown 编辑器无法正确识别段落，难以利用。

- **有颗粒度的双链**。这一点是众所周知的，无需赘言。在后面我会对此提出新的评论。

- **优雅的UX**。Roam 各种 UX 设计，是创造性的。使用 Roam 做笔记，就像在写网页一样，彻底摆脱了以文档为中心的传统电子笔记组织方式。

尽管如此，我仍决定放弃使用 Roam。这也有几个原因：

- **收费过于昂贵**。这不仅阻止了用户，也影响了它的寿命。 Roam 已经无法给人们们提供长久的信心。Reddit 上不断有人问，“[Roam 死了吗？](https://www.reddit.com/r/RoamResearch/comments/17vtghr/is_roam_research_still_in_active_development_or/?utm_source=share&utm_medium=web2x&context=3)”

- **开发陷入停滞**。没有迹象表明，将来能够在 Roam 中充分利用 AI 技术。

- **搜索功能孱弱**。使用 Roam 记笔记是非常愉快的，但每次写文章搜索资料却很痛苦。目前没有任何迹象表明，Roam 的开发者意识到了这个问题。

- **块引用双链并没有那么重要**。这些年的实践表明，块引用双向连接没有达到预期的效果。我们其实没有什么时间回顾这些链接。最实用还是是页面引用链接，也就是使用`[[]]`添加的链接。它们使我们彻底摆脱了笔记的传统组织方式，并使得记笔记像建设网站，阅读笔记像浏览网站那样。

- **编辑器的稳定性问题**。Roam 的编辑器性能一直很好。偶尔出现问题，经过反馈，也能及时修复。然而，最近几个月，中文输入又出问题了。在打中文时，经常出现直接键入字母而不是汉字的问题。之前，由于 Roam 有相当数量的中文用户，会有不少人会反映问题。而现在，Roam 的中文用户可能寥寥无几了吧。可能也正因于此，中文输入的问题久久不被注意和修复。

- **可迁移性太差**。如果使用 Roam 做了很多块引用，将来的迁移数据成为可怕的事情。不可能有无损的迁移方案。将来你的笔记将充满一堆`((8g_o_giEe))`之类的字符串。使用 Roam 的方法建立的笔记体系，可能一朝化为乌有。

- **前景不明**。任何软件都有终结的一天，或早或晚。Roam 需要登录才能访问自己的数据，让人不禁担忧。尽管官方也考虑过，当 Roam 终结时，以某种方式为其续命，比如开放源代码，但他们现在不愿意做出任何此类承诺。

总之，Roam 的前途是渺茫的。Roam 在国内的著名鼓吹者王树义老师，也放弃了Roam，转投 Tana[^4]。 提供的核心功能不是必须的。[^3]

## 回到笔记的本质

经过这几年的实践，我最重要的一个体会是，应该回到记笔记的本质：**记录**和**检索**。信息技术使记笔记比以往任何时候都更容易，当需要时，也比任何时候都更容易检索。记笔记的日常是，在 Word 程序或纯文本编辑器中写下你的笔记，在将来的某一天检索其中的片段。我们平时根本没有时间浏览和回顾笔记，特别是在经年累月之后。

当然，我不否认应该追求更多的便利。然而，如果一款笔记软件两者其一做得不好，就可能存在致命的缺陷。前面提到，Roam 的检索功能是令人抓狂的。在 Roam 的搜索框搜索关键词，只能一点点的往下滑动寻找。你无法在页面之间筛选，这也意味着你无法快速定位。说实在的是，Roam 的搜索功能甚至不如 Windows 的资源管理器的。假如你在 Word 上记笔记，你的笔记文档都放在一个文件夹里，你可以在资源管理器上搜索关键词，而资源管理器则会返回带有关键词的各个文档的列表。这个操作在印象笔记中也很平常，但在 Roam 中却令人抓狂。

与之相对照，Obsidian 的搜索功能是我目前看到的新型笔记软件中最好的。最重要的是，它可以帮助我们快速定位页面或者说文档。

如图所示，在行中搜索关键词“规范 情感”，然后选择折叠搜索结果，我可以快速定位页面。由于所有的 Obsidian 数据本身就是纯文本的Markdown 文件，这一展示方式是顺理成章的。

![Obsidian 上的搜索](/images/2024-01-01/1.png)

与之相对照的是 Roam 的搜索体验。

![Roam 上的搜索](/images/2024-01-01/2.png)

此外，Roam 提供的 “Search+” 插件也并不提供页面折叠功能，其本身提供的高阶块搜索也是如此。

我认为，在记录和检索之外，笔记软件提供的其他功能仅是锦上添花。不要把简单的事情复杂化。这也是为什么说，新型笔记软实质是一种特殊的电子游戏。

## Obsidian

抛开其他问题，Obsidian 是非常理想的笔记软件。如前所述，它的检索功能十分强大和便利，远超 Roam。此外，它完全是本地化的，软件所处理的数据是纯文本。附件的管理也十分方面。它也提供页面引用功能，而这种功能其实是近年来笔记软件最重要的突破。

这些本地化的纯文本数据，经过精心组织和整理，将来接入 AI 技术也是非常容易的。现在已经出现一些实验性的项目。想一想，将来在 Obsidian 中通过 AI 模型挖局我们的笔记数据，与我们的笔记对话。这应该在未来的一两年内就会实现。

完全无需担心 Obsidian 的持久性问题。即使终止开发，我们仍然可以继续使用它。不像 Roam，无需任何登录操作就可以读取和操作笔记数据。使用 Obsidian 不会让我们产生类似 Roam 的焦虑和担忧。Obsidian 是能够让我们有信心使用十年甚至一辈子的笔记软件。

不过，Obsidian 只能提供极为有限的大纲编辑功能。以大纲方式编辑的文本，无法像Roam 那样方便的利用。主要的问题还是，在行与行之间没有空行，无论复制到普通 Markdown 编辑器中还是 Word 中，都不能正确识别段落。

如果你正在使用 Obsidian ，并且正在考虑 Roam，我的建议是，坚守前者。你可能不需要块引用功能，由此也无需承担可能的成本。现在，单纯记录和检索你的笔记，然后期待，将来 AI 技术在 Obsidian 中的实现。对于那些依赖大纲编辑器的人而言，比如我自己，则正在考虑将 Workflowy 作为我的主力大纲编辑器。经过检验，它非常稳定，超过了 Roam 和 Logseq。

## Logseq

我很早就尝试 Logseq。这是一款 Roam 的劣质模仿品。相比 Roam，Logseq 的双链功能细节相当差。使用过的人应该很清楚这一点。Logseq 的软件开发有着严重的问题。首先，它的开发者不会管理软件开发。随着迭代更新，经常反复出现某些问题。一开始某些问题被修复了，但随着新的版本改动，它们又出现了。此外，原先本来好好的功能或特性，后来被无聊地修改成难用的东西。与其开发者沟通发现，他们在开发的过程中并没有想到要维持原有特性的稳定。这让人十分恼火。还有， Logseq 在设计新特性时，总是浅尝辄止。我曾在 Discord 写长文抱怨这些问题，但未见改观。整体来说，Logseq 的开发一直处于顾此失彼、缝缝补补的状态。单就是编辑器，直到最近才稳定下来。

不过，Logseq 的本地化数据设计要比 Roam 好。这使其与 Obsidian 更接近。如果将来 Logseq 停止更新，我们仍然可以继续使用软件并且保有我们的数据。将来如果 AI 技术发展，也有望在 Logseq 上利用。

然而，由于 Logseq 的开发者根本不会进行开发管理，使用 Logseq 的过程像是一种冒险历程。要知道，Logseq 的开发已经进入了第 **5** 个年头了。如今它还处于alpha阶段。这真的令人难以想象！至今，Logseq 都没有把一些功能固定和稳定下来，出一个稳定可用的版本，然后继续开发新功能和修复未知错误。

现在，我在Roam 中的数据已经完美迁移到 Logseq 。但只是将其作为某种备份。根据我以往的经验，只要深度使用 Logseq，就会遇到各种糟心的事情。

对于那些可以忍受以上提到的问题的人们来说，Logseq 是很有前景的一款笔记软件。仍然，我不推荐任何稍微有点头脑且有点脾气的人用 Logseq，因为 Logseq 的开发者真的毫无任何软件开发管理能力！

## Workflowy

最后不得不提一下 Workflowy 。作为大纲笔记的祖师爷，在 Roam 之后，它其实并没有被超越。这两年积极开发了许多新的功能。Workflowy 依然简洁、优雅、强大，并且，看起来生命力远比 Roam 更强大。

我很欣赏 Workflowy 漂亮的看板。它可与大纲灵活转换。此外，就是它稳定的编辑器。现在，得益于[新的导出功能](https://blog.workflowy.com/paperback-writer-paragraphs-and-headers-now-available/)，在 Workflowy 可以轻松撰写长文了。假使你依赖大纲编辑器，平时写材料在大纲编辑器中完成，然后又想在完成之后直接利用，那么现在可以考虑使用 Workflowy 了。它甚至比 Roam 还要好用，超越了市面上所有的大纲类笔记软件。

此外，Workflowy 的搜索功能变得更加强大。就文本搜索这一方面而言，检索特定关键词之后，Workflowy 只显示带有该关键词的节点，并且自动展开它们，无论它们本来是打开的还是收起的。与 Roam 简直可以说有云泥之别，甚至比 Obsidian 还要优雅。

总之，无论是记录还是检索，Workflowy 都不落后于市面上任何的笔记软件。

当然，Workflowy 本质上是一个 Web 程序。它没有本地化的数据，使用前必须登录。这始终有些令人不放心。

我仍考虑回归 Workflowy ，并且衷心推荐那些依赖大纲编辑器的朋友们尝试或者回归这款软件。只有一点，我们需要做好数据的备份。

## 结语

我已经很久没有纠结和折腾新的笔记软件了。有许多新型笔记软件我在上面并没有提及，诸如 [Heptabase](https://heptabase.com/)、[Tana](https://tana.inc/) 等等（甚至还可以说，包括Notion）。这是因为，出于接下来将要总结的理由，应该将它们与 Roam 做类似的考虑。

1. 新型笔记软件的实质是一种新型电子玩具。[^2]沉迷于新型笔记软件等“效率”工具，和沉迷于电子游戏没有区别。当今互联网三大电子玩具：效率工具、博客程序和电子游戏,今后如有机会我还会详细讨论。

2. 记笔记的本质是记录和搜索。原则上，使用任何文本编辑器都能记笔记（OneNote例外，它的搜索功能是个废物）。新型笔记软件仅仅是使记笔记这件事提高了一点效率，增添了一些乐趣。一些新型笔记软件由于搜索功能孱弱，甚至会降低效率。

3. 选择笔记软件应该考虑长远性。本地化、免费使用，是选择笔记软件时最重要的特性。选择一种软件就是选择一种方法和技术。无损迁移数据是不可能的。依照这个标准，不应该深度依赖 Workflowy、Notion、Roam 这样的程序。Obsidian 或 Logseq 则是相当不错的选项。如果依赖大纲编辑器，则选择 Logseq，否则，Obsidian 是最佳选择。

4. 页面双链块双链更重要。页面双链颠覆了以文档为单位组织笔记的传统方式，而块引用的实际作用没有人们预想的那样大。假如坚持使用 Roam，请从现在开始，尽量减少使用块引用，这将为将来的迁移提供不少便利。

我自己的最终方案或许是这样的：日常使用 Workflowy ，并且定期备份至 Obsidian，将这两种软件结合着使用。将来如果实践方案成熟，我还会再写一篇文章。

[^1]: [如何在 Roam Research 做学术研究：一个实例](/blog/how-to-use-roam-research)
[^2]: [新型电子游戏：笔记软件或博客程序](/blog/note-taking-is-new-electronic-game)
[^3]: 一些有关 Roam Research 的（唱衰）文章：[The Fall of Roam](https://every.to/superorganizers/the-fall-of-roam)， [Why note-taking apps don't make us smarter ](https://www.platformer.news/why-note-taking-apps-dont-make-us/)；一个综述：[Roam Research — What comes after a renaissance?](https://productidentity.co/p/4-roam-research-what-comes-after)。这是可预料的。的确，除了撰写+搜索模式的一般笔记软件之外。任何新型笔记软件都只会是少数人的玩具（这些人同时还玩各种[新型电子游戏](/blog/note-taking-is-new-electronic-game/)）。只是我希望在它真的陨落那天，Roam Research 能够允许人们继续在本地使用而无须登录。
[^4]: [我为什么把「第二大脑」从 Roam Research 迁移到了 Tana ？](https://wangshuyi.substack.com/p/roam-research-tana)


这篇文章依照作者对记笔记这件事的本质的理解，逐个点评各类新型笔记软件，并且给出选择它们的建议。当然，文章的重点不在于详细介绍和对比各类软件的特性。

标签 roam research