Note Guidelines
Note Guidelines
In order to work with the Digital Garden plugin, there are a few conventions each note should follow. All notes should be markdown files (.md
).
Header
This goes at the beginning of each file.
---
title: Example
tags:
- example-tag
dg-publish: true
dg-permalink: example
---
title
- The title of the note. When published, the title goes at the top of the page.tags
- Relevant tags for the note. Notes can have multiple tags, but they should be formatted on new lines with a leading hyphen as seen above.dg-publish
- This should betrue
if you want the note to be published orfalse
if not.dg-permalink
- This sets the note's URL on the site. It should be relatively short.
Callouts
The Digital Garden plugin supports callouts. There are no specific conventions for when they should be used, as long as it makes sense.
Code Blocks
Code blocks should use the xls
syntax highlighter. While it won't be visible in Obsidian, the site's syntax highlighter will handle it.
Wikilinks
The Digital Garden plugin supports wikilinks. Use them when possible, and don't be afraid to make dead links to be filled later.