Have you ever felt you want to have your text in a versatile and light format and don’t find an easy way? This post is for you!

Some months ago I started to write reports to prepare myself to write reports for my chartership. Why prepare? Is it really necessary? Well… yes, definitely yes.

Preparation matters: true story…

As university student I have had to elaborate the Degree Final Projects (Bachelor’s, Master’s and Bachelor’s again), plus a long list of academic works, reports, lecture notes, presentations… and trust me, the preparation matters. There are many examples but styling is probably one of the most visual cases.

My final project reached the 1000 pages. Before submitting it I passed onto my director for a last check. Guess what? Image footers needed to be left aligned, instead of centre aligned. WTF?! Imagine to do that one by one? ONE BY ONE??? Luckily, I was using LibreOffice that allowed text hierarchy and style customization. This made the gargantuan reformatting task as long as 2 minutes as all the text within the document had perfectly defined categories associated with their corresponding style. I only needed to update the style associated to the image footers and done. If I had used a platform with a poor style management, such us the Windows Notepad I would have been in a serious problem.

This is the importance of the right choice in advance.


Obviously, before choosing the right tool you need to decide what will you produce.

Is not the same to write a short report or a novel, use many mathematical expressions or not, need to draw diagrams or not, need to collaborate with more people or write on your own, need to export it to PDF or to a blog…

There are a pile of tools out there and each one is specialist in one field.


In my case I usually don’t have very clear how I am going to export my document…maybe as a post? or I will keep it for me as a plain text note? or it might be used for a presentation?

This is a pain. I don’t want to decide at documents early stages what will I do with my document. Because usually I have no clue!

Madoko solves this (and many other) problem(s) for me. Madoko is based on Markdown. This means you write plain text, which brings many advantages:

  • Self readable: you can perfectly read it without any format.
  • Editability: it’s a plain text, you can open it with anything!
  • Longevity: you will always have a program to open your plain text.
  • Procesablity: as plain text can be easily imported and processed to carry out checkings, batch formatings, etc. or simply extract the information to use it somewhere else.

Till here, nothing different to Markdown. So, what does Madoko offer that Markdown doesn’t?

  • LaTeX full support: great if you are a LaTeX user. You can keep your formulas while writing in a much more friendly way. Is way much easier to read a Markdown code than a LaTeX code.
  • Multiple export: PDF + HTML + slides. You can export your document to a PDF in case you are looking to create a book or a printable document. You can also generate a website, or go even further and create a web-based presentation (which is great because you just need any browser to run it!).
  • CSS based style management.
  • Offline CLI or online GUI. The online GUI offers a nice editor with many options.
  • Dropbox, GitHub and other platform integration for synchronization.

how can I say it… it was love at first sight. Now I can focus on my content and worry about the formatting later on. I will always be able to access my information from anywhere, and doesn’t matter I don’t have internet, the “code” itself is so clear and clean you can read it easily without any render. I can issue my reports on PDF to print them and hand a hard copy to my mentor or simply upload an static HTML to a temporary repository and share the link with my mentor so that he can access it from anywhere (avoid paper waste!). I still can’t imagine where the slides might be useful for my chartership…but as we say in my mother tongue: everything will come.


Here the a video of the author, Daan Leijen, explaining Madoko’s capabilities:


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s