Will RDoc be able to parse markdown here? I'm guessing not. I'd leave this file unchanged and [note that by using README.rdoc that file will be included](https://github.com/rails/rails/pull/11950/files#r5885845).