Foam是一个受Roam Research启发的个人知识管理和共享系统，基于Visual Studio Code和GitHub构建。
您可以使用Foam来组织研究，保留可重复发现的笔记，编写长篇内容以及（可选）将其发布到网络上。
Foam是免费的，开放源代码的，并且可以进行扩展以适合您的个人工作流程。您拥有使用Foam创建的信息，可以自由共享它，并与所需的任何人协作。
Foam是一种工具，支持在思想和信息之间建立关系以帮助您更好地思考。
无论您是想组建第二脑或Zettelkasten，写一本书，还是只是想长期学习变得更好，如果遵循以下简单规则，Foam都可以帮助您组织思想：
按照入门指南为您所有的知识和研究创建一个Foam工作区。
在降价文档中写下您的想法（我喜欢称其为Bubbles，但这可能不止是一点点推文）。这些文档应该是原子的：将属于一起的内容放入一个文档中，并将其内容限制为该单个主题。 （ 资源）
使用Foam的快捷方式和自动完成功能将您的想法与[[wiki-links]]关联在一起，并在它们之间导航以浏览您的知识图。 使用[graph-visualisation]（⚠️WIP）概述您的Foam工作区，并使用[backlinking]发现思想之间的关系。 泡沫就像一个浴缸：从中得到的泡沫取决于放入的泡沫。 Foam的编辑体验由VS Code提供支持，工作空间设置将[建议的扩展名]和为编写和浏览信息而优化的首选项结合在一起，从而增强了工作效率。 为了备份，协作并在设备之间共享您的内容，Foam与GitHub可以很好地配对。 要发布您的内容，您可以将其设置为以零代码和零配置发布到GitHub Pages，或发布到任何网站托管平台，例如Netlify或Vercel。 Fo️Foam仍在预览中。 期望体验会有些粗糙。
这些说明假定您具有GitHub帐户，并且已安装Visual Studio Code。 使用泡沫模板项目生成新的存储库。 如果您已登录GitHub，则可以点击以下按钮： 如果您想保留自己的想法，请记住将存储库设置为私有，或者如果您根本不想使用GitHub托管工作区，请选择“下载为ZIP”而不是“使用此模板”。 使用文件＆gt;将存储库作为文件夹打开。 打开...菜单项。 在VS Code中，“开放工作区”是指多根工作区。 当提示您安装推荐的扩展时，单击全部安装（如果要逐一查看和安装它们，请单击“显示推荐”）。 设置存储库后，打开.vscode / settings.json并编辑，添加或删除您想要的Foam工作区设置。 如果您发现某些问题，请在GitHub上查看我们的问题；如果发现某些问题，请创建一个新问题！
泡沫没有传统意义上的功能。开箱即用，您可以使用VS Code的所有功能以及选择安装的所有[建议扩展名]，但您可以自行决定如何使用它！
Foam的目标是成为您寻求知识的私人伴侣。
相对于我想到的所有功能，目前大约“准备就绪10％”，但我只想到了它可能拥有的大约1％的功能，我很高兴向其他人学习。
我将其用作个人思考工具。通过公开，我不仅希望向他人学习如何改善Foam，而且还要改善我学习和管理信息的方式。
如果这听起来像是您感兴趣的事情，那么我很乐意帮助您。
随时打开GitHub问题，向我提供有关新功能的反馈和想法。
没有Visual Studio Code和GitHub，就不可能实现Foam，并且极大地依赖于我们出色的开源[commension-extensions]及其所有贡献者！