silverbullet/website/SilverBullet.md

SilverBullet aims to be your workshop for the mind: a creative environment where you collect, create and expand your personal knowledge in primarily textual form, while also letting you constantly evolve the tools you use to do so.

While you can use SilverBullet as a simple note taking application that stores notes in plain markdown files on disk, it becomes truly powerful in the hands of more technical power users. By leveraging Metadata annotations, its Objects infrastructure, Live Queries and Live Templates, SilverBullet becomes a powerful end-user programming tool, enabling you to quickly develop various types of ad-hoc knowledge applications.

SilverBullet is implemented as an open-source, self-hosted, offline-capable web application.

You’ve been told there is no such thing as a silver bullet. You were told wrong.

Quick links

• Install: how to install and deploy SilverBullet
• Manual: the beginnings of a user manual
• CHANGELOG: SilverBullet is in very active development, so things change rapidly. Watch this to see what’s new and changed.
• Roadmap: currently planned features and priorities
• Issues: if you have ideas, or find bugs, please report them
• Discussions
• Mastodon: Follow SilverBullet development on Mastodon
• Discord: For more real-time support and discussion, join our Discord!

Features

SilverBullet...

• Runs in any modern browser (including on mobile) as a PWA in two Client Modes (online and synced mode), where the synced mode enables 100% offline operation, keeping a copy of content in the browser, syncing back to the server when a network connection is available.
• Provides an enjoyable Markdown writing experience with a clean UI, rendering text using Live Preview, further reducing visual noise while still providing direct access to the underlying markdown syntax.
• Supports wiki-style page linking using the [[page link]] syntax. Incoming links are indexed and appear as “Linked Mentions” at the bottom of the pages linked to thereby providing bi-directional linking.
• Optimized for keyboard-based operation:
  • Quickly navigate between pages using the page switcher (triggered with Cmd-k on Mac or Ctrl-k on Linux and Windows).
  • Run commands via their keyboard shortcuts or the command palette (triggered with Cmd-/ or Ctrl-/ on Linux and Windows).
  • Use Slash Commands to perform common text editing operations.
• Provides a platform for end-user programming through its support for Objects, Live Queries and Live Templates.
• Robust extension mechanism using 🔌 Plugs.
• Self-hosted: you own your data. All content is stored as plain files in a folder on disk. Back up, sync, edit, publish, script with any additional tools you like.
• SilverBullet is open source, MIT licensed software.

To get a good feel of what SilverBullet is capable of, have a look at this (slightly out of date) introduction video.

url: https://youtu.be/VemS-cqAD5k

Try it

Here’s the kicker:

==You are looking at a (more or less) operational copy of SilverBullet right now==.

That’s right, this very website is powered by SilverBullet itself. 🤯

On this site, everything is editable, just none of it syncs back (successfully) to the server. You are editing a local copy of this website, so changes do persist locally.

Don’t just sit there, try it!

• Click on the page picker (book icon) icon at the top right, or hit Cmd-k (Mac) or Ctrl-k (Linux and Windows) to open the page switcher. Type the name of a non-existent page to create it (although it won’t save in this environment).
• Click on the terminal button (top right) or hit Cmd-/ (Mac) or Ctrl-/ (Linux and Windows) to open the command palette (note that not all commands will work in this mode).
• Select some text and hit Alt-m to ==highlight== it, or Cmd-b (Mac) or Ctrl-b (Windows/Linux) to make it bold, or Cmd-i (Mac) or Ctrl-i (Windows/Linux) to make it italic.
• Click a link somewhere on this page to navigate there.
• Start typing [[ somewhere to insert a page link (with completion).
• Tap this box 👈 to mark this task as done.
• Start typing :party to trigger the emoji picker 🎉
• Type / somewhere in the text to invoke a slash command.
• Click this button {[Editor: Toggle Vim Mode]} to toggle Vim mode
• Open this site on your phone or tablet and... it just works!
• Are you using a browser with PWA support (e.g., any Chromium-based browser)? Click on that little icon to the right of your location bar that says “Install SilverBullet” to give SB its own window frame and desktop icon, like it is a stand-alone app (not particularly useful on silverbullet.md, but definitely do this once you install it yourself). Now, unplug your network cable and reload the page. It still works!

Oh yeah, and you can use fancy things like tables:

Page	Comment
SilverBullet	Main product page
CHANGELOG	The latest updates

or code snippets, like JavaScript:

function helloWorld() {
   return "Hello there!"
}

or YAML:

name: SilverBullet
rating: 5

Going deeper

Where things get really interesting is when using features like Live Queries that allow you to query all types of Objects indexed based on the pages in your space.

Let’s explore this with a meta example of using this functionality for this very website. All pages in this space that represent a 🔌 Plugs are tagged with the #plug tag. Now, if we would want to render a list of all plugs in one place using the template/plug template, we can simply do this:

plug render [[template/plug]]

Hover over that list, click the edit button to see the query that generates this view.

And it’s not just pages that can be queried, there’s a large variety of queriable sources and you can define your own via tags. Examples include tasks, pages, tags, and links.

For instance, here’s a list of all outgoing page links from this page:

link where page = "{{@page.name}}" select toPage as name render [[template/page]]

The sky is the limit. See Objects and Live Queries for more information.

Install SilverBullet

Has your mind been sufficiently blown to commit to an install? Took you long enough, alright then. Please proceed to Install and enjoy!

Where to go from here

Have a lock at our work-in-progress Manual.

Support

If you (hypothetically) find bugs or have feature requests, post them in our issue tracker. Want to contribute? Check out the code.

Want to chat with us? Join our Discord!