Table of Contents

What is Foam

Foam is a local, markdown-first personal knowledge management system that organizes notes as interlinked text files. It focuses on bi-directional links, backlink discovery, and a lightweight graph model that helps you build a network of ideas while staying in your preferred editor.

Compared with Obsidian, Foam is more editor- and developer-oriented because it runs on top of Visual Studio Code and leverages existing file and git workflows. Compared with Roam Research, Foam uses plain markdown files rather than a proprietary database which makes notes portable and versionable. Compared with Notion, Foam is intentionally minimal and file-based, trading rich blocks and hosted databases for local control and scriptable workflows.

All of this makes Foam especially well suited for technical users, writers, and researchers who want strong control over file formats, version history, and integration with development tooling. It excels when you want a private, portable knowledge base that plays well with git and other developer tools.

How Foam Works

Foam stores each note as a markdown file in a workspace folder and links notes using wiki-style or markdown links. The system builds a graph of those links so you can navigate ideas through backlinks, link suggestions, and a visual graph view.

The typical workflow centers on an editor, most commonly Visual Studio Code, plus the Foam VS Code extension. You create notes, add links or tags, and review backlinks to discover relationships; changes stay as files so you can use git for history, branching, and collaboration.

Because Foam is file-based, syncing happens through standard file-sync or version control tools. You can keep a Foam workspace in a Git repository, push changes to GitHub, and use familiar Git workflows for collaboration and backup.

Practical example: create a new note for a research topic, link it to related notes with [[wikilinks]], then run the graph view in the editor to identify missing connections and follow backlink trails to expand your notes.

Foam features

Foam centers on several core capabilities for building a networked knowledge base in plain markdown, with recent improvements focused on editor integrations and link discovery. Core features include wiki-style linking, backlink navigation, VS Code tooling, templates, and git-friendly storage.

Let’s dive into the standout features:

Wiki-style links and markdown compatibility

Foam supports both wiki-style links and standard markdown links so notes remain interoperable with other markdown tools. This approach makes importing and exporting straightforward while preserving link relationships across tools.

Backlinks and link discovery

The system automatically indexes backlinks and surfaces references to a note so you can see how ideas connect across your workspace. This helps with associative thinking and turning loose notes into structured knowledge.

Graph view and visualization

Foam provides a visual graph that maps notes and their connections, making it easier to spot clusters, isolated notes, and linking opportunities. The graph is useful for mapping research, topic clusters, and knowledge areas.

VS Code extension and editor tooling

A dedicated Foam extension for Visual Studio Code adds commands, link completion, templates, and quick navigation that make note creation and linking fast from within the editor. The extension also exposes snippets and workspace helpers to streamline note workflows.

Git-based workflow and syncing

Because notes are plain files, Foam works naturally with git for version control, branching, and remote backups. This enables code-like workflows for notes, including PR-based review or multi-branch research experiments.

Templates and note scaffolding

Foam includes templates and snippet support to standardize note structure, such as literature notes, project notes, and daily journals. Templates accelerate consistency across a personal or team knowledge base.

With these features you get a text-first, portable knowledge system that integrates with developer workflows and gives you full control over your data and version history.

Foam pricing

Foam is distributed as free, open-source software and does not use traditional subscription tiers. The project is available for local use at no cost and can be self-hosted or version-controlled using standard tools.

Because Foam is file-based and community-maintained, optional paid services can appear around it such as third-party hosting, commercial sync services, or editor plugins, but the core Foam code and extension are freely available. Explore the official Foam documentation and Foam’s GitHub repository for download and installation instructions.

What is Foam used for

Foam is commonly used for personal knowledge management, research note-taking, and building a developer-friendly second brain. Users adopt Foam to capture ideas, write progressive notes, and connect items across topics using links and backlinks.

Teams and individuals also use Foam for project documentation, design notes, and meeting minutes when they prefer file-based storage and git-driven collaboration. It is particularly useful where portability, plain text, and scriptability are priorities.

Pros and Cons of Foam

Pros

  • Editor-first workflow: Foam integrates tightly with Visual Studio Code which speeds up note creation, navigation, and linking for users who live in an IDE.
  • Open-source and portable: Notes are plain markdown files that can be moved, versioned, and backed up with standard tools without lock-in.
  • Strong git support: Using git for history and collaboration fits developer workflows and enables branching, PRs, and code review for notes.
  • Flexible linking model: Wiki-style links, backlinks, and graph visualization help surface connections and support tools-for-thought practices.

Cons

  • Higher technical bar: Foam expects familiarity with editors like VS Code and basic git; non-technical users may find setup and workflows challenging.
  • No official hosted sync: Core Foam does not include an official cloud sync service or native mobile app, so cross-device syncing requires third-party solutions.
  • Minimal out-of-the-box UI polish: Compared to hosted knowledge platforms, Foam’s UI relies on the editor and extensions rather than a polished standalone application.

Is Foam Free to Try?

Foam is free and open-source. You can download the core project and the VS Code extension at no cost, and run a full Foam workspace on your local machine using the official Foam documentation and the Foam GitHub repository.

Foam API and Integrations

Foam does not provide a hosted API; instead it integrates through editor extensions and file-based interoperability. The Foam VS Code extension exposes editing commands and link helpers within the editor environment.

Integration points are primarily file and git oriented so you can use third-party sync services, static site generators, or custom scripts to extend Foam. Because it uses standard markdown, Foam interoperates with many tools that read and write markdown files.

10 Foam alternatives

Paid alternatives to Foam

  • Roam Research — A web-based networked note tool that emphasizes block-level linking and graph-based navigation, with a subscription model for hosted use. Explore Roam Research at its official site: https://roamresearch.com.
  • Notion — An all-in-one workspace with rich blocks, databases, and templates aimed at teams and individuals who prefer a hosted, collaborative environment. Learn more about Notion at https://www.notion.so.
  • Evernote — A long-standing note-taking app with rich media support, web clipping, and subscription tiers for syncing and advanced features. See Evernote at https://evernote.com.
  • Obsidian — A local markdown knowledge app with a plugin ecosystem and optional paid services for sync and publish, combining GUI convenience with file portability. Visit Obsidian at https://obsidian.md.
  • Craft — A document-focused app with a polished interface and team features for structured documentation and note sharing. Check Craft at https://craft.do.
  • Bear — A minimalist markdown editor with tagging and a subscription for sync and pro features, geared toward writers and note-takers. View Bear at https://bear.app.

Open source alternatives to Foam

  • Logseq — A local-first, markdown/EDN-based outliner and knowledge graph that supports daily notes and backlinks. See Logseq at https://logseq.com.
  • Joplin — An open-source note-taking app with markdown support, encryption, and sync via various backends. Explore Joplin at https://joplinapp.org.
  • Trilium Notes — A hierarchical note-taking application with scripting and rich linking capabilities for complex knowledge structures. Find Trilium Notes at https://github.com/zadam/trilium.
  • TiddlyWiki — A single-file, highly customizable wiki that runs locally or in the browser and is popular for personal knowledge projects. Learn more about TiddlyWiki at https://tiddlywiki.com.
  • Zettlr — A markdown editor built for academic writing and note linking, with citation management and export options. See Zettlr at https://www.zettlr.com.

Frequently asked questions about Foam

What is Foam used for?

Foam is used for building a personal or team knowledge base with interlinked markdown notes. People use it for research, writing, project documentation, and developer-centric note workflows.

Does Foam cost money?

No, Foam is free and open-source. The core project and editor extension are available without charge and can be self-hosted or backed up with git.

Can Foam sync notes across devices?

Yes, Foam syncs via file-based tools such as git, Dropbox, or other sync services. You manage syncing outside of Foam by storing your workspace in a synced folder or Git repository.

Does Foam have an API for integrations?

Foam does not provide a hosted API, but integrates through editor extensions and file interoperability. Use the Foam VS Code extension or standard file workflows to connect with other tools.

Can Foam import notes from Obsidian or Roam?

Foam works with standard markdown so importing from Obsidian or other markdown-first tools is straightforward. Converting from Roam may require exporting to markdown first, then importing into a Foam workspace.

Final verdict: Foam

Foam stands out as a lightweight, markdown-first toolkit for people who prefer editor-centric, file-based knowledge systems. It does particularly well at keeping data portable and versionable, and it integrates cleanly with git-driven workflows that many developers already use.

Compared with Obsidian, Foam is more developer-focused and leans on VS Code and git rather than a standalone app with a plugin marketplace. Foam’s price point is effectively free since the core project is open-source, while Obsidian offers a free core app plus paid sync and publishing services for users who want hosted features.

If you are comfortable in Visual Studio Code, want plain text portability, and prefer to manage syncing and history with git, Foam is an efficient and flexible choice. If you need a polished standalone app with a large plugin ecosystem and out-of-the-box mobile clients, a hosted or GUI-first alternative may be a better fit.