Obsidian is a [[Markdown]]-based note taking and knowledge management system. It is closed source and based on [[Electron.js]].
Despite this, a large community has sprung up around it, and its focus on plain text files with a simple extensible interface with a non-hostile business model has made it a welcome reprieve from the always online toxic alternatives out there.
- Website
- [GitHub](https://github.com/obsidianmd/obsidian-releases/releases) (for releases and plugin inclusion only, no source code)
- Documentation
- AlternativeTo
> QUOTE
# Notability
My current note taking and all around [[KM]] application since February 2023.
It's annoying that a closed-source application like this beats the many other competing open source apps not just on usability but also on non-shitty monetization strategies. To be clear, that is a compliment to Obsidian.
# Philosophy
# OS Support
# Features
# Tips
## See Also
- [[Soft Links]]
- [[UUIDs in Obsidian]]
- [[Plugin Development]]
- [[Exporting from Evernote]]
- [[Autogenerating Progress Bars]]
- [[Converting HTML to Markdown]]
- [[CRT Monitor Styled Codeblocks using CSS]]
- [[Custom Stylesheets]]
- [[Multi-Column]]
## Callouts
```
INFO
TODO
IMPORTANT
QUESTION HELP FAQ
WARNING CAUTION ATTENTION
FAILURE FAIL MISSING
DANGER ERROR
BUG
EXAMPLE
QUOTE CITE
```
I have also added custom callouts:
```
IDEA
FIXME
```
## Obsidian URI & MIME-Type Handling on Linux
See also: [[Linux Desktop Entry Files]]
To get `obsidian://` and similar working.
Make sure to run this if you make changes to a desktop file, particularly if the changes don't seem to be propagating:
```shell
update-desktop-database
```
If for some reason, Obsidian URIs are being opened with another app (eg a web browser) then you can change the association using [[gio]]:
```shell
gio mime x-scheme-handler/obsidian obsidian.desktop
```
Or using `xdg-mime`:
```sh
xdg-mime default obsidian.desktop x-scheme-handler/obsidian
```
Or manually edit the MIME association:
```shell
nvim ~/.config/mimeapps.list
```
```ini
[Default Applications]
x-scheme-handler/obsidian=obsidian.desktop
```
## Cross-Linking Between Multiple Vaults
**Why**: Because I want to keep my main vault small for better performance and ease of backing and version control while storing large files in a separate vault/repo.
Use Obsidian's URI support:
```markdown
[Some Note](obsidian://vault=My%20Other%20Vault&file=Some%20Note)
```
This even works with non-Markdown files:
```markdown
[Some PDF](obsidian://vault=My%20Other%20Vault&file=Some%20PDF.pdf)
```
It isn't the most elegant to type, but this can be improved through the use of other tools like [[Obsidian Plugin - Templater]].
```markdown
[null](obsidian://open?vault=null&file=null)
```
I have incorporated this into the [[Library Link (snippet)]] template.
## Multiple Configurations
- https://help.obsidian.md/Files+and+folders/Configuration+folder
## Fixing Broken Graph View
### Problem
Due to a change in lib Mesa the GPU cache files are no longer compatible with previous versions. Trying to load the old cache files breaks Obsidian’s Electron from being able to successfully acquire a OGL context.
### Solution
>[!WARNING] Update [[2024-06-17]]
> This does not consistently fix the issue anymore.
Delete `~/.config/obsidian/GPUcache`.
```sh
rm -rf ~/.config/obsidian/GPUcache
```
To fix this problem for everyone and prevent it from happening in the future I propose that Obsidian purge the `GPUcache` during every update.
### References
- https://gitlab.freedesktop.org/mesa/mesa/-/issues/9431
- https://forum.obsidian.md/t/graph-view-not-loading-a-graph-linux/64654/12
# Resources
```cardlink
url: https://publish.obsidian.md/hub/00+-+Start+here
title: "00 - Start here - Obsidian Hub - Obsidian Publish"
description: "00 - Start here - Obsidian Hub - Powered by Obsidian Publish."
host: publish.obsidian.md
favicon: /favicon.ico?e0c23a326e3abd13ae50
```
# References
```cardlink
url: https://forum.obsidian.md/t/cross-vault-internal-links/28798/8
title: "Cross-vault internal links"
description:
host: forum.obsidian.md
favicon: https://forum.obsidian.md/uploads/default/optimized/3X/a/b/abf9faf124ba8edea7e6e644ec69d669b49baa30_2_32x32.png
image: https://forum.obsidian.md/uploads/default/original/3X/b/a/ba1a1301f580d34a881803aa5ed8cf7ff3cdf0ef.png
```
```cardlink
url: https://forum.obsidian.md/t/obsidian-uri-set-up-for-linux-obsidian-desktop/7494/10
title: "Obsidian URI set up for Linux / obsidian.desktop"
description: "Got you this makes sense this is what the terminal returns: appimagekit_c2a39878767986b435d0a31ec4395864-Obsidian.desktop this one doesn’t return anything, not sure why It shows at the very end of a list of files under this [Default Applications] itshows the following handler/obsidian=appimagekit_662bbdc1ca79f8d4ec9971260b077778-Obsidian.desktop it’s very strange, I don’t use GNOME. I’m on Manjaro XFCE The promt to “Open With” is not a real problem since after putting “Remember C..."
host: forum.obsidian.md
favicon: https://forum.obsidian.md/uploads/default/optimized/3X/a/b/abf9faf124ba8edea7e6e644ec69d669b49baa30_2_32x32.png
image: https://forum.obsidian.md/uploads/default/original/3X/b/a/ba1a1301f580d34a881803aa5ed8cf7ff3cdf0ef.png
```
```cardlink
url: https://forum.obsidian.md/t/url-scheme-doesnt-work-on-linux/5794
title: "URL Scheme doesn't work on Linux"
description: "Steps to reproduce Have two vaults vaultA and vaultB (no spaces in their names). vaultA has a note noteA With Obsidian closed, try to open an Obsidian URL either in the browser or through xdg-open: obsidian://vault/vaultB obsidian://vault/vaultA/noteA obsidian://vault/vaultA With vaultA open in Obsidian try to open either of these: obsidian://vault/vaultB obsidian://vault/vaultA/noteA Try the absolute path to noteA obsidian:///home/argen/vaultA/noteA Expected result With vaultA op..."
host: forum.obsidian.md
favicon: https://forum.obsidian.md/uploads/default/optimized/3X/a/b/abf9faf124ba8edea7e6e644ec69d669b49baa30_2_32x32.png
image: https://forum.obsidian.md/uploads/default/original/3X/b/a/ba1a1301f580d34a881803aa5ed8cf7ff3cdf0ef.png
```
```cardlink
url: https://help.obsidian.md/Concepts/Obsidian+URI
title: "Obsidian URI - Obsidian Help"
description: "Obsidian URI - Obsidian Help"
host: help.obsidian.md
favicon: https://publish-01.obsidian.md/access/f786db9fac45774fa4f0d8112e232d67/favicon.ico
```