Update .yardopts to markdown

Update .yardopts file to reflect new use of markdown in docs.

This might be the cause of #764.

Related: should `AUTHORS`, `LICENSE` and/or `CHANGES` be added to the files to be included?