silverbullet/website/SilverBullet.md

63 lines
5.9 KiB
Markdown
Raw Normal View History

2023-12-19 19:58:18 +08:00
# Introduction
2024-02-06 04:47:05 +08:00
SilverBullet is a note-taking application optimized for people with a [hacker mindset](https://en.wikipedia.org/wiki/Hacker). We all take notes. Theres a million note taking applications out there. [Literally](https://www.noteapps.ca/). Wouldnt it be nice to have one where your notes are _more_ than plain text files? Where your notes essentially become a _database_ that you can query; that you can build knowledge custom applications on top of?
2022-11-25 23:01:05 +08:00
2024-02-04 04:01:32 +08:00
This is what SilverBullet aims to be.
2023-11-15 16:31:52 +08:00
2024-02-06 06:32:26 +08:00
Absolutely. You use SilverBullet to quickly jot things down. Its a notes app after all. However, this is just the beginning. Gradually, you start to annotate your notes using [[Frontmatter]]. You realize: “Hey, this note represents a _person_, let me [[Tags|tag]] it as such.” Before you know it, youre turning your notes into [[Objects]]. Then you learn that in SilverBullet you can [[Live Queries|Live Query]] these objects. Your queries grow into reusable [[Templates]] written using a powerful [[Template Language]]. You find more and more uses of these templates, for instance to create [[Page Templates|new pages]], or [[Live Template Widgets|widgets]] automatically added to your pages.
2024-02-06 04:47:05 +08:00
And then, before you know it — you realize youre effectively building applications in your notes app. [[End-User Programming]], yall. Its cool.
2023-12-19 19:58:18 +08:00
You may have been told there is _no such thing_ as a [silver bullet](https://en.wikipedia.org/wiki/Silver_bullet).
2023-11-25 21:30:31 +08:00
You were told wrong.
2024-02-06 04:47:05 +08:00
# What is SilverBullet?
SilverBullet is open source **personal knowledge management system** implemented as an offline-capable web application ([[PWA]]). In order to use it, you have to **self-host** it: that is, you need to run a web server either on your own machine, somewhere on your network, or in the cloud somewhere. See our [[Install|installation instructions]]. Yes, this requires a bit more work than downloading a desktop app. But get a lot in return.
2022-11-27 15:48:13 +08:00
2023-11-25 21:30:31 +08:00
# Features
2024-02-04 04:01:32 +08:00
* SilverBullet is a **web application** and therefore instantly accessible wherever a (modern) web browser is available, without the need to install a 200mb Electron app, nor unreliable or proprietary sync setups.
2024-02-06 04:47:05 +08:00
* SilverBullet is a [[PWA]] that supports two [[Client Modes]]: [[Client Modes#Online mode]] and [[Client Modes#Synced mode]]), where the _synced mode_ enables **100% offline operation**, keeping a copy of the content in the browsers local ([IndexedDB](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API)) database, syncing back to the server when a network connection is available.
2024-02-04 04:01:32 +08:00
* **Self-hosted**: _you own your data_. Your [[Spaces|space]] is stored as plain files in a folder on disk on your server. Back it up, sync, edit, publish, script it with any additional tools you like.
2023-12-19 23:18:33 +08:00
* SilverBullet provides an enjoyable [[Markdown]] writing experience with a clean UI, rendering text using [[Live Preview|live preview]], further **reducing visual noise** while still providing direct access to the underlying markdown syntax.
2024-01-28 13:30:40 +08:00
* SilverBullet 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_.
2023-12-19 23:18:33 +08:00
* SilverBullet is optimized for **keyboard-based operation**:
2022-11-27 18:21:03 +08:00
* Quickly navigate between pages using the **page switcher** (triggered with `Cmd-k` on Mac or `Ctrl-k` on Linux and Windows).
2023-07-08 02:21:50 +08:00
* 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.
* SilverBullet is a platform for [[End-User Programming]] through its support for [[Objects]], [[Live Queries]], [[Live Templates]] and [[Live Template Widgets]], allowing to make parts of your pages and UI dynamic.
2024-02-04 04:01:32 +08:00
* SilverBullet allows you to boost your writing/knowledge collection productivity using its various [[Templates]] mechanisms including powerful [[Snippets]] and [[Page Templates]].
* SilverBullet can be extended using [[Libraries]] and [[Plugs]].
2023-12-19 23:33:38 +08:00
* SilverBullet is free, [**open source**, MIT licensed](https://github.com/silverbulletmd/silverbullet) software.
2022-07-15 20:59:47 +08:00
2023-12-19 23:33:38 +08:00
To get a feel of what SilverBullet is capable of, have a look at this (always ever so slightly out of date) introduction video.
2023-01-21 20:37:55 +08:00
```embed
2023-11-17 23:53:39 +08:00
url: https://youtu.be/BbNbZgOwB-Y
2023-01-21 20:37:55 +08:00
```
2023-12-19 23:33:38 +08:00
2023-11-25 21:30:31 +08:00
# Try it
2022-11-27 16:12:24 +08:00
Heres the kicker:
2022-07-17 03:14:10 +08:00
==You are looking at a (read-only) version of SilverBullet **right now**.==
2022-11-25 20:36:42 +08:00
Thats right, **this very website is powered by SilverBullet itself**. 🤯
2022-11-25 20:36:42 +08:00
Except... _you cannot edit anything_. But dont despair, head to [play.silverbullet.md](https://play.silverbullet.md) and login with user `silverbullet`, and password `silverbullet` to get the editable experience (in an environment that resets itself every 15 minutes).
2023-11-25 21:49:02 +08:00
2023-11-25 21:30:31 +08:00
# Install SilverBullet
2024-02-04 04:01:32 +08:00
Convinced to install this yourself? Please proceed to [[Install]], and enjoy!
2024-02-06 04:47:05 +08:00
# What next?
* [[Manual]]: how to use this thing.
* [[CHANGELOG]]: were in active development, so things change rapidly. Watch this page to keep up.
* [Roadmap](https://github.com/orgs/silverbulletmd/projects/2/views/1): currently planned features and priorities.
* [Community](https://community.silverbullet.md): join our community: ask questions, share your experiences.
* [Issues](https://github.com/silverbulletmd/silverbullet/issues): if you have ideas or find bugs, please report them.
* [Discord](https://discord.gg/EvXbFucTxn): for more real-time support and discussion.
* [Mastodon](https://fosstodon.org/@silverbulletmd): follow SilverBullet development on [Mastodon](https://joinmastodon.org/).
2023-11-25 21:30:31 +08:00
# Support
2023-12-19 23:33:38 +08:00
If you (hypothetically) find bugs or have feature requests, post them in [our issue tracker](https://github.com/silverbulletmd/silverbullet/issues). Want to contribute? [Check out the code](https://github.com/silverbulletmd/silverbullet).
2022-11-27 18:21:03 +08:00
And... join our [community](https://community.silverbullet.md/)!