Writing is central to almost any academic activity and something I do every day, yet little attention is given to the tools and processes that enable writing to happen effectively and without throwing away your computer after trying to edit Word-files for five hours.
This tutorial covers some of the tools and processes that have helped me so far. I am still learning and experimenting and expect to update this page along the way. What this tutorial will not cover, however, is how to communicate clearly through writing. I list some books and resources that I have found helpful at the bottom of the page.
You don’t have to use expensive and clunky software like Word to get your writing done, but it is unfortunately still the standard in my part of academia. There are ways to avoid writing your own content in Word but still get output in .docx for your colleagues and academic journals who require it. The solution is spelled markdown.
The core idea in markdown is that you, as a writer, should only have to worry about the content of your text, not the formatting. Formatting like adding italic or bold is added when you render the document but does not display in your document. For someone like me, who keep telling myself that getting the margins of the word document just so will somehow magically do the trick, markdown is a huge relief.
Another advantage of using markdown is that you can render many output formats. For example, the content for this website is written in markdown, and the same text could have been rendered into .docx or .pdf in just a few seconds.
There is an extension to markdown called RMarkdown which lets you create documents that blend text with R code. The resulting document now creates your results (figures & tables included) while simultaneously formatting the text. What a quantum leap in reproducible science!
Markdown takes 5 minutes to learn but will benefit you as soon as you write something that is supposed to be formatted to specific criteria or published to the web.
More about markdown
There are several excellent choices and I recommend that you try a few of them before deciding. Here are my recommendations:
- iA Writer - this is my favourite because it has great default options so that I don’t end up tweaking the settings but start writing
- Ulysses - beautiful and easy to use, but I don’t like that I have to subscribe
- Typora - very elegant UI
- Atom - Atom is mainly used for code but can be modified to work well for academic writing
- RStudio - If you are just getting started, the RStudio interface is an OK writing environment. I prefer other tools when I’m just writing though
Resources on writing
- How to Write a Scientific Paper
- Broad Institute communications kit
- How to write a rebuttal letter
- The uneven U
- How to write effectively for international journals
- How to write a first-class paper
- Good Transitions
- How many drafts should you write?
- Easy Reading Is Damn Hard Writing
- Five common writing mistakes new scientists make
- How to Be a Writer: 10 Tips from Rebecca Solnit
- Training to Be a Good Writer
- How to Write: An Index of Ways to Improve your Writing Skills
- Write Like You Talk
- Clinical Chemistry Guide to Scientific Writing
- 10 tips for more concise writing
- De-stuffing your writing
- How to write a well-structured essay
- Academic Phrasebank
- How to write paragraphs
- How to find your writing flow
- The pursuit of excellence in research and writing
- How to write a review article that people will read
- Training for the Productivity Load in Academia
- Quoting and paraphrasing
- The Secrets to Good Paragraph Writing
- Helping students write a literature review
- “Writing doctoral research”: Learning through peer critique and feedback
- Dan Simons Writing Tips
- Writing for an academic journal: 10 tips
- How to write a Nature-style review
- Paper not working? Try the “what’s the problem?” approach
- Authorial voice, or “Putting on the Ritz”
- Structuring and writing academic papers
- Three rules for making academic text easier to read
- Tackling a messy first draft
- Improving your academic writing: My top 10 tips
- Write Beginner Drafts to Make Writing Happen
- Reverse Outlines