From 41dd1d649127ae2833f5a4b1c3b6b6cb571117d8 Mon Sep 17 00:00:00 2001 From: Tanner Collin Date: Fri, 22 Apr 2022 16:16:17 -0600 Subject: [PATCH] Improve docs --- README.md | 25 ++++++++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index a25d5c0..859fcad 100644 --- a/README.md +++ b/README.md @@ -24,9 +24,16 @@ This plugin can be installed via: pip install git+git://github.com/jonathan-s/pelican-obsidian@main#egg=pelican-obsidian +Add `'obsidian'` to the `PLUGINS` list in your Pelican config: + +``` +PLUGINS = [ + 'obsidian', +] +``` + Usage ----- -Install the plugin as described in the pelican documentation. In the tags section you will be able to use `#` without that being reflected in the actual name of the tag. In other words. @@ -37,9 +44,21 @@ Tags: #my-tag my-tag in the html output. ``` -The backlinks in Obsidian follows this format `[[ document | Actual link name ]]` The actual link name is optional. +Links follow this format: + +``` +[[note name]] +[[note name | custom link text]] +``` + +Files are similar: + +``` +![[photo.jpg]] +![[photo.jpg | custom alt text]] +``` -To specify the location of an attachment the following syntax is used `![[ filename.jpg ]]`. They explain more about the syntax in the section on [how to embed files](https://help.obsidian.md/How+to/Embed+files) +They explain more about the syntax in the section on [how to embed files](https://help.obsidian.md/How+to/Embed+files) Future features