Markdown and YAML both have some surprising syntactic corner cases. You discover misfeatures by implementing and using. Design is hard.