obsidian-markdown

Essential Principles

Wikilinks for vault content - use [[Note Name]] for internal notes and vault files because Obsidian tracks renames and resolves aliases. Use [text](url) only for external URLs.
Properties stay in frontmatter - put YAML properties at the very top, fenced by ---, because Obsidian only treats that block as note properties.
Tags are metadata, not prose decoration - use #tag inline only when the tag is meaningful in reading context; otherwise prefer the tags: frontmatter list.
Embeds use wikilink syntax - use ![[Note]] or ![[image.png]] for vault embeds because standard Markdown image syntax does not resolve Obsidian note targets.
Prefer readable notes over syntax density - Obsidian syntax should improve navigation or rendering; avoid links, tags, callouts, and embeds that do not add retrieval value.