autodocs - use markdown format in ruby documentation comments

- added YARD_OPTIONS to allow overriding the defaults
- 2.24.4
Merge pull request #16 from yast/yard_markdown

autodocs - use markdown format in ruby documentation comments