Opensidian turns any Nextcloud folder of Markdown files into a linked knowledge base. Write notes in a full-featured editor, connect them with [[Wikilinks]], visualise your knowledge as an interactive graph, and chat with your notes using any OpenAI-compatible AI - all without leaving Nextcloud.
- CodeMirror 6 editor - full-featured Markdown editor with split-pane live preview, syntax highlighting, and auto-save
[[Wikilink]]syntax - shortest-path resolution links notes by name; a backlinks panel shows every note that references the current one- Force-directed knowledge graph - press
Ctrl+Gto explore your entire vault as an interactive D3 graph with emoji colour coding per note category - AI chat panel - connect any OpenAI-compatible API (OpenAI, Ollama, LM Studio, local models…); the assistant uses your active note and its linked notes as context
- Hierarchical file tree - drag-and-drop, rename, delete, and create notes from
.templates/folder templates - Vault indexing - all wikilinks and backlinks are indexed in the background on vault open; a progress indicator shows while indexing
- Light / dark theme - follows your Nextcloud appearance setting automatically; font size adjustable in Settings
- No lock-in - notes are plain
.mdfiles stored in your Nextcloud files; open them in any editor
| Dependency | Version |
|---|---|
| Nextcloud | 25 – 33 |
| PHP | 8.0+ |
- Clone or download this repository into your Nextcloud
custom_apps/directory:cd /path/to/nextcloud/custom_apps git clone https://github.com/markusbegerow/nextcloud-opensidian nextcloud-opensidian - Enable the app:
php occ app:enable opensidian
- Open the Opensidian entry in the Nextcloud navigation bar.
- Click Open vault in Settings → Vault and enter a path relative to your Nextcloud home folder (e.g.
Notes). The folder will be created if it does not exist. - Use the file tree on the left to create, rename, and organise notes. If a
.templates/folder exists in your vault, new notes can be created from templates. - Write
[[Note Name]]anywhere in a note to create a wikilink. Click it to navigate; the Backlinks panel on the right shows all notes linking to the current one. - Press
Ctrl+G(or click Graph) to open the force-directed graph view. Nodes are coloured by the emoji prefix of the note title - define your colour system in.configs/colors.md. - Click Chat in the right panel and configure your LLM in Settings → AI & LLM (API URL, model, token). The assistant receives your active note and its linked notes as context automatically.
- Press
Ctrl+Sto save manually; the editor auto-saves as you type.
If you encounter any issues or have questions:
- 🐛 Report bugs
- 💡 Request features
- ⭐ Star the repo if you find it useful!
If you like this project, support further development with a repost or coffee:
- 🧑💻 Markus Begerow
- 💾 GitHub
- ✉️ Twitter