Ah, it is github specific extension, which doesn't work with yardoc e.g. see https://help.github.com/articles/github-flavored-markdown