Undocumented markdown creates multi-line headings for text followed by --- on a new line

The 1Password markdown page tells part of the story. IMO it would be useful to mention the effect if you don't leave an empty line above and below "---" because it's the only way to get adjacent lines with a heading format (starting each line with ## puts a space between lines).

Yes, it's part of the markdown standard, but if there's are more markdown features supported by 1Password than are documented at 1Password.com then a link to a relevant full reference page would be useful.