Obsidian Vault Integration
Obsidian is the preferred way to use Amethyst. You can either create a new Obsidian Vault or link one that your already have.
New Vault #
Linking an existing Vault (simple) #
The easiest way to use an existing Vault is to copy all of your files (directory and hierarchies intact) into the
Linking an existing Vault (using git) #
If you’re editing in an existing vault and don’t want to have to keep copying your files over, one solution is to create a new Git repository for just the notes you want to publish.
Then, in both your vault and in Amethyst, run the following command, replacing the link with one to your new repository:
git submodule add https://github.com/<YOUR_USERNAME>/<REPO_NAME> content
Now that you’ve added your notes to Amethyst, let’s fix some settings so that they play well.
- Under Options > Files and Links, set the New link format to always use Absolute Path in Vault.
- Go to Settings > Files & Links > Turn “on” automatically update internal links.
Inserting front matter everytime you want to create a new Note gets annoying really quickly. Luckily, Obsidian supports templates which makes inserting new content really easily.
If you decide to overwrite the
/content folder completely, don’t remove the
Head over to Options > Core Plugins and enable the Templates plugin. Then go to Options > Hotkeys and set a hotkey for ‘Insert Template’ (I recommend
[cmd]+T). That way, when you create a new note, you can just press the hotkey for a new template and be ready to go!
👀 Step 4: Preview Changes