What are the challenges using Markdown for documentation?

Yandex talks about why they choose Markdown and are building tools for it and what the challenges are in the process and how to solve them. More on here https://onp4.com/@aleks/bd2f0