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.
Madoko integrates seamlessly with Dropbox, Github, and, Onedrive, and automatically synchronizes all changes in the cloud. This way, your document is always available anywhere from any device.
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?
All the rendering for the preview and HTML export is done locally
in the browser on your computer – Madoko is a Javascript
program written in Koka and runs inside the browser.
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 snapshot/document-date
sub-folder.
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:
TexRaw
blocks 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
document.
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?
Enjoy :-)
– Daan Leijen