diff --git a/website/index.md b/website/index.md index 98a30e87..13590ec3 100644 --- a/website/index.md +++ b/website/index.md @@ -1,10 +1,16 @@ # Silver Bullet ## Markdown as a platform -Silver Bullet (SB) is a highly extensible, open source **personal knowledge playground**. At its core it’s a Markdown-based writing/note taking application that stores _pages_ (notes) as plain markdown files in a folder referred to as a _space_. Pages can be cross-linked using the `[[link to other page]]` syntax. This makes it a simple tool for [Personal Knowledge Management](https://en.wikipedia.org/wiki/Personal_knowledge_management). However, once you leverage its various extensions (called _plugs_) it can feel more like a _knowledge playground_, allowing you to annotate, combine and query your accumulated knowledge in creative ways, specific to you. +Silver Bullet (SB) is highly-extensible, open source **personal knowledge management** software. Indeed, that’s fancy language for “a note taking app with links.” -What does Silver Bullet look like? Well, have a look around. **You’re looking at it at this very moment!** Say what!? +At its core SB is a Markdown editor that stores _pages_ (notes) as plain markdown files in a folder referred to as a _space_. Pages can be cross-linked using the `[[link to other page]]` syntax. This makes it a great tool for [Personal Knowledge Management](https://en.wikipedia.org/wiki/Personal_knowledge_management). However, once you leverage its various extensions (called _plugs_) it can feel more like a _knowledge playground_, allowing you to annotate, combine and query your accumulated knowledge in creative ways, specific to you. -Feel free to make some edits, to get a feel for it. Don’t worry, you won’t break anything, nothing is saved (just reload the page to see). +Cool, no? + +What does Silver Bullet look like? Well, have a look around. **You’re looking at it at this very moment!** + +Note that this is not a fully functional version, because the back-end is read only. However, it should give you some feel for what it’s like to use SB before making that massive commitment of running a single `npx` command (see below) to run it locally in its fully functioning mode. + +Feel free to make some edits in this space. Don’t worry, you won’t break anything, nothing is saved (just reload the page to see). Things to try: @@ -19,7 +25,7 @@ Things to try: * Open this site on your phone or tablet and… it just works! ## Explore more -Click on the links below to explore various of Silver Bullet more in-depth: +Click on the links below to explore various aspects of Silver Bullet more in-depth: [[🤯 Features]] [[💡 Inspiration]] @@ -32,6 +38,14 @@ More of a video person? Here’s two to get you started: * [A Tour of Silver Bullet’s features](https://youtu.be/RYdc3UF9gok) — spoiler alert: it’s cool. * [A look the SilverBullet architecture](https://youtu.be/mXCGau05p5o) — spoiler alert: it’s plugs all the way down. +## Principles +Some core principles that underly Silver Bullet’s philosophy: + +* **The truth is in the markdown.** And markdown is simply text files stored on disk. No proprietary formats or lock in. While SB uses a database for indexing and caching some data, all of that can be rebuilt from its markdown sources at any time. +* **What you see is what it is.** No magic or hidden content. +* **Single mode.** SB doesn’t have a separate view and edit mode. You’re always in edit mode, and you like it that way. +* **Extend it your way**. SB is highly extensible, and you can customize it your liking and your workflows. + ## Installing and running Silver Bullet Like what you’re seeing? Install it yourself locally or on your server! It’s free.