There are potential conflicts between the YAML spec and Obsidian. # is a reserved character for comments, and  are reserved characters for flow styles. What does that mean for including tags and links?
By definition YAML isn’t markdown, but many programs accept it for the utility of the Front Matter conventions. The — fences are a simple visual cue - most people prefer it to counting backticks.
For some uses I prefer to have Metadata parsed as part of the main text, but usually I want it excluded and not rendered. And it’s nice when it works the same in other programs and the YAML solution is the only way that does that.
There’s huge inconsistency in implementations of comments in markdown. Some work in Obsidian, others don’t, but none are a commonly accepted way of indicating a Metadata block.
And some people prefer to have their YAML block at the end rather than the beginning, but still refer to it as Front Matter.
Personally, I’d most like the developers to decide soon. I’d rather implement a method than not, but it’s off-putting to be aware it might have to be changed.
MultiMarkdown officially supports YAML frontmatter for metadata. This is also used by several online blogs that take raw markdown submissions for articles. It’s also used by several static site generators - like Hugo and Jekyl. It seems to be the de facto standard if we want to extend markdown documents with metadata.
YAML front matter is very important, used already by all major markdown editors, and is standard in MultiMarkDown. if it gets properly managed by Obsidian, we could in the future write plugins to read/write/manage the metadata and it’ll be awesome!
I am kinda confused with how Obsidian handles YAML front-matter though. If I understand correctly, the YAML front-matter is reserved for plugins to read and write metadata after the public API is released. If so, what are the best practices if I want to use YAML to add custom, user-generated metadata? Should I add a second YAML block after the one reserved for plugins?
The concept of YAML is very new to me so thanks in advance for your patience and help!