writing and photography

Why you should write in markdown ⬇️

Ever since I decided to move to all-digital note-taking, over the past few years, I’ve used a number of note-taking apps to find what works best for me. During this pursuit for the ideal note-taking app, I realised that two features were essential for my purpose.

A. Storing notes in plain text files

B. Basic text formatting

The only way that I know of to achieve both A and B is with markdown.

What is Markdown?

Markdown is an easy way for anyone to write notes in plain text with some basic styles and formatting. It was created in 2004, by John Gruber and Aaron Swartz. You can find the complete syntax here.

Adoption

Over time, the standard evolved and various flavours of markdown emerged. This obviously poses some compatibility issues. You can find more about some of these standards here. To resolve this issue while maintaining the utter simplicity of Markdown, a number of services, websites and programming languages adopted the now most popular flavour of markdown: CommonMark.

How does this benefit me in particular?

Writing Tools

In case you are looking for recommendations, here are some tools that I use for markdown note-taking and are worth exploring. Having tried numerous alternatives, I find these to be among the best markdown editors for most people, although they come with slightly different feature sets and use-cases:

writing tools

  1. Bear: Private Markdown Notes for iPhone, iPad and Mac
  2. iA Writer: The Benchmark of Markdown Writing Apps
  3. Obsidian: A second brain, for you, forever
  4. 1Writer: Powerful, beautiful Markdown editor for iOS

My favourite among them is bear as it brings together just the right mix of features that makes most sense for me, especially because it allows linking to notes within other notes. It is also great in terms of aesthetics and ease of use. No matter how many different apps I try, I always keep coming back to this one and it has now remained my note-taking app of choice for at least the last 3 years.

iA writer comes in a close second and I use it especially when I find the need for their 'style check' feature that automatically reviews your text to highlight redundancies and filler words.

Obsidian is the most promising new tool out there for markdown note-taking. Presently there is no mobile version (but is being built). However, its strongest feature is the implementation of links between various notes coupled with the graph view of all linked notes.

1writer is a great mobile companion app for users who find Obsidian to be their desktop app of choice.

Conclusion

  1. Write notes digitally using plain text files to make them durable.
  2. Use markdown to add structure and formatting, making your notes richer and more readable while keeping them in the plain text files.
  3. Use a tool specifically designed to handle commonmark markdown syntax along with some advanced features such as search, backlinks, tags and whatever else you find useful for your purpose.

Do these three things and note-taking will never be the same again!


#notes #productivity #writing

read more
reading, note-taking and writing
personal knowledge management with linked notes
what should you write about in your notes