Github Flavored Markdown in YARD

markdown_yard.md

Github Flavored YARD

Thanks to http://blog.nikosd.com/2011/11/github-flavored-markdown-in-yard.html

# Gemfile

group :development do
  gem 'yard'
  gem 'redcarpet'
  gem 'github-markup'
end

And in .yardopts:

# .yardopts

--markup-provider=redcarpet
--markup=markdown

Quick note, you'll also need yard-coderay if you want it to highlight languages other than Ruby: lsegal/yard#1278

Since https://github.com/lsegal/yard/releases/tag/v0.9.27 CommonMarker is supported! lsegal/yard#1388