Using Markdown Like an Academic
[This post originally appeared at Gradhacker on 2012-11-20]
Markdown, a text formatting syntax designed for easy readability but also transformability, gets a lot of love from geeks. Lincoln Mullen has written a great introduction to Markdown for Profhacker if you are unfamiliar with the syntax. My big question when I made the shift away from traditional word processors and began using plaintext and markdown was if it would be flexible enough to support the conventions of scholarly work. After all, if the format wouldn’t support footnotes, tables, figures, and so on, it wouldn’t be much use since such conventions are expected across the genres we use in scholarly writing and publishing.
Much of our work involves writing emails, notes, drafts of manuscripts, blogs, ideas, fellowship applications, and so on. Until about year ago, all of this work took place in Microsoft Word. But I increasingly grew frustrated with Word getting in the way of getting my work done. Auto-formatting, proprietary document formats, and its complexity no longer fit my workflow. So, I turned to plain text.
I was part of a larger wave of adoption among Internet nerds who were turning to Markdown as a writing format. Simultaneously, I was making a move between operating systems. I left Windows for Linux, and then Linux for OS X. The shift to another operating system led me to confront the issue of proprietary file formats head on, and further convinced me to pursue plain text for its near universal adaptability to any computing platform.
To get the most out of plain text, I turned to Fletcher Penny’s MultiMarkdown, which adds additional features to Markdown especially useful for academics. My last large academic project – writing my comprehensive exams – was completed entirely using MultiMarkdown and transformed into file formats I could share with my examiners with John MacFarlane’s Pandoc.
MultiMarkdown gives writers a greater range of tools for writing more complex material. Footnotes, for example, are represented by
[^1] and correspond to the note such as:
This sentence needs a citation.[^1]
[^1]: This is the citation.
When the document is converted into PDF, HTML, Word document, or other format, the footnote will appear as expected. If things start getting a little messy, Dr. Drang has a Python script that will clean up Markdown reference links. In addition, if you are using Pandoc for transforming text, you can use its flavor of Markdown to do inline footnoting.^[Which looks something like this.]
MultiMarkdown also handles tables, styled like this:
This may all seem complicated, but writing in Markdown is easier than trying to write about it. MultiMarkdown has many other features that academics will find useful, such as math support, image attribution, and figure captions.