What on earth are you talking about? What’s wrong with our beloved and old companion Microsoft Word?
What is Markdown?
Markdown is a syntax language aiming for easy reading and writing of structured text. There are multiple implementations of the language (such as Github flavored Markdown) and each of these implementations have some own improvements and features that are not necessarily compatible with each other. Still each implementation bases on the same default syntax and when done right Markdown files are cross-compatible between different implementations.
Markdown is easy to learn and it only requires text editor to create your first document. The original Markdown syntax supports the following features:
By using just these features you can write out almost any document you could with Word. Markdown also supports inline HTML that can be used to create content that the syntax doesn’t support.
Why would you use it?
There are lots of things that speak for Markdown and why it’s superior over .docx or .doc files. Here to list few of them:
For these reasons I would suggest you at least try it out. There are online editors available for Markdown such as Dillinger or StackEdit. These editors also show you the rendered output in real time and are the fastest way to get to know Markdown. For actual documentation I suggest that you use some local editor such as Vim — especially if you are working on business sensitive documents.
What about other markup languages?
There are MANY other markup languages for example Textile (used for example in JIRA). I don’t see any problem with any of those as long as they can actually do the same things as Markdown does and provide the same advantages. Just try them and find out which suits you the best.
Task for you
If you are new to Markdown and actually tried it out I would love to hear your opinions how it would fit for your daily work! In case you are already using Markdown or any other markup language for your daily work, please let me know of good tools and practices using it. Especially automating documentation process (file conversions, online documentation etc.) is really something I would love to hear more about.
Also please share this story if you find this interesting way of doing documentation.
Here is a list of tools that might help you on the way:
I am Heikki Hellgren, Software developer and technology enthusiast working at Elektrobit Automotive. My interests are in software construction, tools, automatic testing and all the new and cool stuff like AI and autonomous driving. You can follow me on Medium and Twitter. Also you can check out my website for more information.