Why I Love These Markup Languages


Around this time last year, I wrote a brief introduction to various markup languagesfor this column. The topic of language selection has come up several times recently, so I thought it might be time to revisit the subject with my biases more overt. I’m here to explain why I prefer the languages I do, not to prescribe anything for you. After all, I’m no doc-tor.

A colleague asked my opinion of a post comparing reStructuredText and Markdownfor technical documentation. My company’s docs are written in reStucturedText rendered with Sphinx, but I’ve made noise from time to time about moving to something like DocBook XML. …

Read more at OpenSource.com