autodocs - use markdown format in ruby documentation comments

- added YARD_OPTIONS to allow overriding the defaults
- 2.24.4