Use markdown in yardoc

[ci skip] 43.33% documented
Merge branch 'fix-yard'