The sea of editors

There are many thousands of different text-document editors available. You can choose to use an online editor like Stackedit or Dillinger or you can use locally installed editors like Notion, Macdown, Word or VS Code. All these editors have their advantages. Word is the defacto Office document processor, VS Code is used today by millions of software developers and Macdown is a simple Markdown editor. But which one to choose?


As a software developer I learned to keep things extremely simple and usable. When I write software, I don’t want to be distracted by features that are hard to know or understand. And I want to be able to read the documents with all editors by hand. The latter requires a simple format known as plain/text. There is no formatting in the file and what you see is what you get.

To understand text easily we are used to some simple formatting helpers:

formatting helpers | 250 This helps to understand and memorise the text better. The combination of both plain/text files and formatting is provided by Markdown created by John Gruber and Aaron Swartz.

Why am I using Markdown?

In 1994 I started to use Windows 3.1 and there was Word. How cool! I can add graphics, colours for the text and so on. What a mess the results have been is history. Then while developing editorial systems (wrongly also known as CMS) for the web we added WYSIWYG editors (what you see is what you get) and the websites wer colourful with various different fonts and styles and … what a mess again.

But what one wants is simple accessable information that is formatted well. That’s the basic idea behind Markdown. Here is an example of a simple text formatted with Markdown:

# Top news brought to you by Andy

## Software developer discovers a new way of creating simple an well readable text with a formatting technic called Markdown.

Hamburg, 12.05.2010. A software developer from Hamburg, Germany discovered the new formatting technic to create nice and readable text. He was _extremely happy_ to discover **Markdown**. This modern way of formatting plain/text is a breakthrough to fight the mess of unreadbale HTML pages in the World Wide Web. 

The basic features are:

* it is simple to learn 
* one needs only a simple text editor
* with additional software like [Pandoc](https://pandoc.org/) the text can be converted into various document formats like **PDF**, **epub** or **HTML**

This text is easily readable and can be read in any text-editor. When using the formatting and converting it, it will look like this: Markdown PDF | 300

When comparing both outputs you immediately get an idea what the formatting is doing: eg. one # will create a headline of order 1 (h1), ## will create a headline of order 2 (h2), **sth** will make the text bold and so on. These are all simple formatting specifications for Markup Languages like HTML (Hyper-Text-Markup-Language). And now you understand, why it is called Markdown and why one of the basic resulting formats when Markdown files are converted is HTML.

It is super simple and handy in the usage.

Which editor to use?

Now it’s becoming philosophical. I think everyone has her loved editor for writing plain/text. If you want something very simple I suggest you give Macdown a try. I really like it and wrote many documents with it. If you also need some better overview about your files I suggest to give these editors a try:

I don’t want to forget mentioning, that there are also good online Markdown editors. One I like is Stackedit. You need to choose if you want to register to a service and save the files there, or use an editor locally where you have full control about your data. Stackedit Online

Export to another format like PDF

The power of markdown is it’s simplicity resulting in the ability to compile (create) a document format of your choice. Most of the editors offer at least the possibility to create a PDF. As I am writing this file in Obsidian, I have the option to export it to a PDF. This will look like this: Export PDF The result: Exported PDF

As you can see the PDF is created. In other editors like Ulysses you have various more options to choose a format and also what style the PDF should be created in.


I love simplicity. And that’s the reason why I write everything in Markdown. You can even omit to use a text-processor like Microsoft word when you use the Markdown editor that gives you everything you need for the output you want to achieve.