PDF, HTML and text documentation from a single file

You might already know this, especially the technical writers and documentation helpers out there, but I only discovered it last week. AsciiDoc uses plain text files with Wiki-like markup to generate wonderful HTML, PDF, manpage, DocBook and of course plain text documentation from one single, easy to manage file. It’s amazing, and since PDF output goes through DocBook, you get totally crisp-looking documents, including source syntax highlighting, pretty quotations and many other goodies. There is even a filter to generate sheet music from text.

Look at the “Overview and Examples” section for an idea of what this can do. I am seriously considering it as an end-user and sysadmin documentation format for leihs and MAdeK. Single-source publishing. Yummy!

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