Repolode
Submit
silverbulletmd

silverbulletmd/silverbullet

A self-hosted, browser-based Markdown note-taking app with wiki-style links, a built-in query language, and Lua scripting.

Open-source alternative to:NotionObsidian SyncRoam Research

View on GitHubWebsite
Stars
6,362
Forks
519
Open issues
365
Last commit
24 hours ago

What is it?

SilverBullet is a personal knowledge base that runs in the browser and can be self-hosted. Notes are stored as a collection of Markdown pages called a Space, and you can navigate them through a page picker like a conventional notes app or through bi-directional wiki-style links.

The editor offers a live-preview Markdown experience, with tools for outlining, task tracking, and objects with a built-in query language (SLIQ). Users who want more control can generate content dynamically, and define custom commands, page templates, and widgets using Space Lua, the project's Lua dialect.

The frontend is written in TypeScript on CodeMirror 6, and the server is written in Rust. Installation is available through Docker or a standalone binary, and the project includes a command-line client named sb.

Key features

  • 01Live-preview Markdown editor with wiki-style bi-directional links
  • 02Built-in objects and a query language (SLIQ) for structured data
  • 03Outlining and task tools for organizing notes
  • 04Space Lua scripting for generating content and custom commands and widgets
  • 05Self-hosted deployment via Docker or a standalone binary

Use cases

  • Keeping a personal wiki of linked Markdown notes
  • Tracking tasks and structured records alongside written notes
  • Building custom note workflows with Lua scripts and page templates
  • Hosting a private team knowledge base on your own server

Quick start

  1. 1

    Build the Docker image from the project folder

    docker build -t silverbullet .
  2. 2

    Run the container and mount your data folder

    docker run -p 3000:3000 -v <PATH-TO-YOUR-DATA-FOLDER>:/data silverbullet

Things to know

  • Building from source requires Node.js 24+ and a stable Rust toolchain.
  • The server-side Lua runtime depends on a headless Chrome backend, which adds weight to self-hosting.

Topics

#note-taking#markdown#lua#knowledge-management#self-hosted#personal-wiki#end-user-programming#personal-knowledge-management

FAQ

What is silverbullet?
A self-hosted, browser-based Markdown note-taking app with wiki-style links, a built-in query language, and Lua scripting. SilverBullet is a personal knowledge base that runs in the browser and can be self-hosted. Notes are stored as a collection of Markdown pages called a Space, and you can navigate them through a page picker like a conventional notes app or through bi-directional wiki-style links.
Is silverbullet free to use? What license does it have?
silverbullet is open source under the MIT license. Check the license terms before using it in commercial products.
Is silverbullet still maintained?
Actively maintained. The last commit to silverbullet was on Oct 20, 2026.
What can I use silverbullet for?
Keeping a personal wiki of linked Markdown notes Tracking tasks and structured records alongside written notes Building custom note workflows with Lua scripts and page templates Hosting a private team knowledge base on your own server
How do I install silverbullet?
Build the Docker image from the project folder: docker build -t silverbullet . Run the container and mount your data folder: docker run -p 3000:3000 -v <PATH-TO-YOUR-DATA-FOLDER>:/data silverbullet
Where can I get silverbullet?
The source code and installation instructions are on GitHub: https://github.com/silverbulletmd/silverbullet

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects