Madoko is a fast markdown processor for writing professional articles, books, manuals, webpages and presentations, with a focus on simplicity and plain text readability.
With Madoko you can write complex documents completely in markdown and get beautiful PDF and HTML output.
Write full-blown academic articles with internal references, mathematical formulas, and bibliographies.
Madoko uses LaTeX to translate formulas and standard bibliography BibTeX files, and can typeset using any LaTeX document style.
Using Markdown is much more pleasant than writing LaTeX directly, and your article will look great in both in HTML and PDF. Madoko is especially good when needing text tranformations, code fragments that need highlighting or proportional fonts, styling through CSS rules, etc.
Through Dropbox and Github, it is easy to share documents with others. Everyone can edit the document where concurrent changes are automatically merged by Madoko (using robust three-way merges).
How is Madoko different?
Madoko implements many features beyond markdown to enable writing serious documents completely in Markdown while giving excellent PDF and HTML output. Read the reference manual to learn more.
Does the Madoko server store any documents?
No, the madoko server just processes mathematical formulas, bibliographies, and PDF exports. All data is sent over an encrypted connection and immediately removed after processing.
Documents are only stored locally in your browser, and on your personal cloud storage. Nothing is retained on the Madoko server.
How can you show a preview?
Do I need to save my document?
No, Madoko continuously saves the current document in browser local storage. You can at any time close the browser or shutdown the computer and your changes are saved. Madoko also automatically synchronizes your changes to the cloud storage every 30 seconds or so. At this point, all your changes become visible to any other devices (and other users if you share the document on Dropbox)
When the local document is synchronized with the cloud, the centered dot behind the name disappears and you know your local changes are backed up in the cloud.
Can I work concurrently with other users on a document?
Yes, Madoko merges concurrent changes automatically. However, currently only Dropbox and Github support full sharing of files in the cloud. Onedrive does not support such sharing at this time.
Is there version control?
When documents are used from Github, full version control is provided and “saving” a document becomes a commit. Also, Dropbox maintains a complete version history of every file automatically (up to 30 days).
Moreover, in Madoko you can use the “Save a snapshot” menu to save a
full copy of the document into a
Finally, you can also set up regular version control through Git or
Mercurial in your cloud synchronized folder.
Can I write my academic paper, manual, book, thesis, etc. in Madoko instead of LaTeX?
Yes! and Madoko makes it especially easy to work with others through Dropbox or Github. It is fairly safe to try out Madoko to write your next paper since:
TexRawblocks you can always fall back to plain LaTeX in a pinch.
Edit this example of a real article with heavy mathematics and code to see how such article can look.
The editor has ‘hick-ups’!
Go to the settings menu (top right) and enable
delayed view updates. This
will only update the view if there is a small pause in typing which
makes the editor much more responsive on a slow browser or large
What browsers are supported?
Madoko.NET has been tested with Chrome version 31+, IE 10+, and Firefox version 27+. Unfortunately, Firefox has a tendency to become slow for larger documents.
Can I run Madoko locally?
Yes! Madoko is free software and runs as a command line program on any system that can run nodejs (Windows, MacOSX, Linux, etc). Follow the installation instructions in the reference manual. This means that you can always continue working on important documents even if the internet is down.
Does Madoko.net work if I am not connected? Yes, Madoko is a “web-app” and works without an internet connection. However, Madoko cannot render mathematical formulas or synchronize to the cloud storage in off-line mode.
What software does Madoko use?
Any useful links?
– Daan Leijen