Ok, this is a link to the RDoc specification . While it isn't all that important to anyone not using the ruby, it's something that I appreciate having. And it's a neat markup language spec in some ways. Neat in that it's simple, easy to mneumonically remember various markup tags, and easy for a human to read. Generally I find that most of the markups tend to only get two of those points right.