Eric J Ma's Website

Notetaking and writing using Atom

written by Eric J. Ma on 2016-07-27


I recently have been trying out the Atom text editor for writing. While its load times are slower than Sublime Text, it overall is a solid text editor. Being free doesn't hurt it either, and being open source and hackable means that (theoretically) I can also extend it the way Sublime Text is extendable too.

Today, I focused on making progress with the Genomic Surveillance whitepaper I'm writing. (Back story - I'm writing this whitepaper to help consolidate ideas and in planning for next career steps.) In particular, I thought of test-driving a system that I cooked up in my head for powering through a section of text.

This system looks as such:

  1. I determine what information needs to be conveyed.
  2. I spend a few hours creating a bullet-point summaries of each paper, but only w.r.t. the necessary information that needs to be conveyed.
  3. I spend another few hours crafting the prose version of the text.
  4. I then build the final PDF as necessary.

The key difference in this experiment compared to my previous attempts is that I am now choosing to write a single section in a purposeful fashion, meaning that my reading is also directed towards a purpose and not merely for the sake of broadening my scope of knowledge (that requires a different type of reading strategy, IMO). On reflection, I think this helps me waste less time reading in-depth things that aren't actually going to be helpful. That skill of strategically and selectively identifying relevant literature to read is something we pick up during graduate school.

Anyways, back to the writing process.

I first wrote the bullet points on their own.

Bullet-point summary of each paper.

A few hours later, once I was done with that, I switched to a two-pane view, and kept the notes on the right and prose on the left.

Writing mode.

A few hours later, I had a draft version written!

As a side benefit, Atom's interface was quite gorgeous. I'm using the default theme, and the default colour scheme easily highlights citations, headers, bullet points/numbers and bold/italicized text. I also totally dig the gutter highlighting that shows me where things have been changed. This is definitely one of Atom's current strengths over Sublime Text. ST currently allows users or packages to set syntax and background colour together, but it's never really been obvious to me how to change font colours based on markdown status. The other benefit is that the file explorer on the left hand side has icons, which really helps navigation.


I send out a newsletter with tips and tools for data scientists. Come check it out at Substack.

If you would like to sponsor the coffee that goes into making my posts, please consider GitHub Sponsors!

Finally, I do free 30-minute GenAI strategy calls for organizations who are seeking guidance on how to best leverage this technology. Consider booking a call on Calendly if you're interested!