Right now our specs are written in psuedo-wiki syntax. This series converts them to markdown. markdown is a simple markup format that's gaining in popularity.
The big advantage of using markdown is that there are tools that can convert it to relatively simple HTML. That means we can build a make infrastructure that generates a nice set of static web pages. The syntax is also more human friendly than mediawiki syntax. To see what the stylized version of this looks like, check out: https://github.com/aliguori/qemu/tree/markdown/docs/specs
