A Roam Research alternative with VSCode, Markdown and GitHub

栏目: IT技术 · 发布时间: 2天前

来源: github.com

内容简介:Foamis a personal knowledge management and sharing system inspired byYou can useFoamis free, open source, and extremely extensible to suit your personal workflow. You own the information you create with Foam, and you're free to share it, and collaborate on



Foamis a personal knowledge management and sharing system inspired by Roam Research , built on Visual Studio Code and GitHub .

You can use Foam for organising your research, keeping re-discoverable notes, writing long-form content and, optionally, publishing it to the web.

Foamis free, open source, and extremely extensible to suit your personal workflow. You own the information you create with Foam, and you're free to share it, and collaborate on it with anyone you want.

In a rush?You could jump to, but I highly recommend reading the introductory sections first. Foam isn't obvious.

Table of Contents

How do I use Foam?

Foamis a tool that supports creating relationships between thoughts and information to help you think better.

A Roam Research alternative with VSCode, Markdown and GitHub

Whether you want to build a Second Brain or a Zettelkasten , write a book, or just get better at long-term learning, Foam can help you organise your thoughts if you follow these simple rules:

  1. Create a single Foam workspace for all your knowledge and research.
  2. Write your thoughts in markdown documents (I like to call them Bubbles , but that might be more than a little twee). These documents should be atomic: Put things that belong together into a single document, and limit its content to that single topic. ( source )
  3. Use Foam's shortcuts and autocompletions to link your thoughts together with [[wiki-links]] , and navigate between them to explore your knowledge graph.
  4. Get an overview of your Foam workspace using a [ graph-visualisation ] ( :warning: WIP), and discover relationships between your thoughts with the use of [ backlinking ].

Foam is a like a bathtub: What you get out of it depends on what you put into it.

What's in a Foam?

Like the soapy suds it's named after, Foam is mostly air.

  1. The editing experience of Foam is powered by VS Code, enhanced by workspace settings that glue together [ recommended-extensions ] and preferences optimised for writing and navigating information.
  2. To back up, collaborate on and share your content between devices, Foam pairs well with GitHub .
  3. To publish your content, you can set it up to publish to GitHub Pages with zero code and zero config, or to any website hosting platform like Netlify or Vercel .

Fun fact: This documentation was researched, written and published using Foam .

Getting started

:warning: Foam is still in preview. Expect the experience to be a little rough.

These instructions assume you have a GitHub account, and you have Visual Studio Code installed.

  1. Create a GitHub repository from foam-template . If you want to keep your thoughts to yourself, remember to set the repository private.
  2. Clone the repository and open it in VS Code.
  3. When prompted to install recommended extensions, click Install all (or Show Recommendations if you want to review and install them one by one)

After setting up the repository, open .vscode/settings.json and edit, add or remove any settings you'd like for your Foam workspace.

To learn more about how to use Foam , read the [ recipes ].

There are [ known-issues ], and I'm sure, many unknown issues! Please report them on GitHub !


Foamdoesn't have features in the traditional sense. Out of the box, you have access to all features of VS Code and all the [ recommended-extensions ] you choose to install, but it's up to you to discover what you can do with it!

Head over to [ recipes ] for some useful patterns and ideas, and

Call To Adventure

The goal of Foam is to be your personal companion on your quest for knowledge.

It's is currently about "10% ready" relative to all the features I've thought of, but I've only thought of ~1% of the features it could have, and I'm excited to learn from others.

I am using it as my personal thinking tool. By making it public, I hope to learn from others not only how to improve Foam, but also to improve how I learn and manage information.

If that sounds like something you're interested in, I'd love to have you along on the journey.

  • Check out [ roadmap ] to see what's in the plans
  • Read about our [ principles ] to understand Foam's philosophy and direction
  • Read the [ contribution-guide ] guide to learn how to participate.
  • Feel free to open GitHub issues to give me feedback and ideas for new features.

Thanks and attribution

Foamis built by Jani Eväkallio ( @jevakallio ).

Foamwas inspired by Roam Research and the Zettelkasten methodology

Foamwouldn't be possible without Visual Studio Code and GitHub , and relies heavily on our fantastic open source [ recommended-extensions ] and all their contributors:


Foam is licensed under the MIT license .

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网







Beginning XML with DOM and Ajax

Beginning XML with DOM and Ajax

Sas Jacobs / Apress / 2006-06-05 / USD 39.99

Don't waste time on 1,000-page tomes full of syntax; this book is all you need to get ahead in XML development. Renowned web developer Sas Jacobs presents an essential guide to XML. Beginning XML with......一起来看看 《Beginning XML with DOM and Ajax》 这本书的介绍吧!

CSS 压缩/解压工具
CSS 压缩/解压工具

在线压缩/解压 CSS 代码

Markdown 在线编辑器
Markdown 在线编辑器

Markdown 在线编辑器

HEX HSV 转换工具
HEX HSV 转换工具

HEX HSV 互换工具