Using Markdown Like an Academic
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:
| Left align | Right align | Center align |
|:-----------|------------:|:------------:|
| This | This | This |
| column | column | column |
| will | will | will |
| be | be | be |
| left | right | center |
| aligned | aligned | aligned |
I keep a TextExpander snippet available to create the base table above and then modify as I need. Once again, Dr. Drang has a script that can clean up Markdown tables.
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.
Have you made the switch to plain text? Have you found Markdown to be useful to your academic workflow?
3 Responses to Using Markdown Like an Academic
-
-
Maxim says:
Markdown is being used by the statistical package R (with knitr library). In essense, one can combine R code that produces tables, models and graphs with some text. You can generate your report/article dynamically, meaning there can be no (added) error in your presentation of the results. One huge drawback concerns citations. Pandoc looks like a possible venue, but I can’t say it is a smooth workflow for the time being.
-
-
-
[…] come across more and more academics who use plain text as well (see posts by Lincoln Mullen and Jason Helper for ideas). I prefer plain text because it gives my […]
-
Leave a Reply Cancel reply
-
Tags
alt-ac anxiety Campus Resources classroom dynamic conferences depression disability dissertation evernote family food fun Google+ grading Health inspiration interdisciplinary job market job search meditation mental health motivation networking Organization parenting personal productivity professional professionalism professionalization research semester break Social Networking software stress students syllabus teaching technology tools Twitter wellness workflow work flow writing -
@GradHacker
-
From all of us at GradHacker: we hope you’re having a great start to the summer. We’ll be back in August!
-
What mistakes did you make at your first conference? @yes_thattoo wants to know: bit.ly/2sRaPuo
-
Heading to your first conference? @yes_thattoo reflects on what went well, and what didn’t. bit.ly/2tOQpzz
-
[…] Using Markdown Like an Academic | GradHacker Bookmark the permalink. […]