Obsidian-compatible
Gasp opens your Obsidian vault as it is. You don't need to import or convert anything. Your notes stay in the same folder. You can keep using Obsidian on them too.
One folder, two apps
Notes/Your vault. Both apps open this same folder..obsidian/Obsidian's settings. Gasp reads them but never changes them..gasp/Gasp's own settings, colors and keyboard shortcuts.Daily/2026-10-21.mdYour notes. Both apps can read and edit them.images/Your pictures and other attachments.
What Gasp draws
Links to other notes, including links to a heading
[[Lemma 2#Proof|the proof]]A note, or part of one, shown inside another note
![[Fourier series#Parseval]]Pictures, at the size you set
![[photo.png|300]]Callouts, the colored boxes for tips and warnings
> [!tip]- FoldedLinks to a single paragraph
^key-resultHighlights
==highlight==Hidden comments
%% hidden %%Tags, listed in a sidebar
#reading/booksMath, shown as finished equations
$e^{i\pi} + 1 = 0$Footnotes
[^1]Checklists
- [ ] Reply to SamTables, which you edit like a spreadsheet
| Site | Hz |Note properties at the top, shown as plain text
tags: [physics]Dataview queries, which need an Obsidian plugin
```dataviewMermaid diagrams, which show as code
```mermaidFootnotes written inside the sentence
^[inline note]
Your Obsidian settings
The first time you open your vault, Gasp offers to copy your Obsidian settings. It brings over your keyboard shortcuts, fonts, accent color and the folder where your attachments go. Afterwards, Gasp shows you a list of every setting it copied.
Opening your vault
- Download Gasp and open it.
- Choose Open a folder and pick your Obsidian vault. Your vault is the folder with a hidden .obsidian folder inside it. If Gasp already has a vault open, use Open another vault instead.
- Gasp offers to Import settings from Obsidian. Say yes to bring over your keyboard shortcuts, fonts and colors.
- You can keep Obsidian installed. When you save a note in one app, the other app shows the change.
Questions
Will Gasp change my Obsidian vault?
Gasp only changes the notes you edit. It keeps its own settings in a separate .gasp folder. It never changes Obsidian's .obsidian folder. Obsidian opens your vault exactly as before.
Can I use Gasp and Obsidian on the same vault at the same time?
Yes. Both apps notice when a note changes. When you save a note in one app, the other app shows the new version. You don't need to close either app.
Do Obsidian plugins work in Gasp?
No. Instead, Gasp has many popular plugin features built in. These include math shortcuts, a table editor, footnote tools and a timer that tracks how long you spend writing each note. Text that needs a plugin, like a Dataview query, shows as you typed it.
Does Gasp work with Obsidian's wikilinks?
Yes. Links written in [[double brackets]] work, including links to a heading or a single paragraph. When you rename a note in Gasp, every link to it is updated, just like in Obsidian.
How do I sync an Obsidian vault with Gasp?
Turn on sync in Gasp's settings. Gasp can sync your vault through your own iCloud Drive, or through a private folder on GitHub that Gasp sets up for you. Both are free. If your vault already syncs with git, Gasp keeps using git.