Single Source Publishing mit Multimarkdown ====================================== Was ist Markdown und warum sollte ich das kennen? ------------------------------------------------------------------ Die, die Markdown kennen, sind meist sehr begeistert. Doch viele haben davon noch nie gehört. Was ist das und warum ist das interessant? ![Markdown-Logo](http://upload.wikimedia.org/wikipedia/commons/4/48/Markdown-mark.svg) Arbeiten mit Markdown heisst im Kern erstmal, Texte zu schreiben. Und zwar in seiner reinsten Form, ohne Formatierung, ohne komplizierte Office-Tools, als reinen Text. Die Idee kam dann auf, das es doch auch bei reinem Text hilfreich ist, wenn man so etwas wie Überschrift, Aufzählung, Absatz, Hervorhebung etc. auszeichnen könnte. Man orientierte sich dabei an der Vorgehensweise, mit der man in eMails solche Auszeichnungen vornahm (noch bevor es tolle eMail-Editoren gab). Und das ging zunächst ganz einfach: Eine Liste wurde z.B. einfach mit \* vor jeder Zeile ausgezeichnet. Überschriften mit # oder eine Hervorhebung mit \* vor und hinter dem Wort oder Abschnitt. Heute wir Markdown in ganz verschiednen Bereichen verwendet, vom Web-Autorensystemen (Wordpress, GitHub) bis zu digitalen Notizblöcken. [Übersicht über Markdown in einem Artikel von Mac&i][Mac&i] Der Vorteil an einer solch ganz simplen Auszeichnung liegt darin, dass man einen Text ähnlich wie in einem Office-Dokument strukturierten kann, jedoch weiterhin nur einen einfachen Texteditor braucht und der Text weiterhin sehr gut Menschen-lesbar bleibt. Es gibt eine Reihe von Vollbild-Editoren, die damit Punkten, dass der Nutzer durch Markdown und Vollbild-Modus möglichst wenig von der inhaltlichen Arbeit abgelenkt wird (disturbence free). Dazu kommt, dass man mit Markdown in einer Art Meta-Sprache schreibt. DIes ermöglicht es, aus dem Markdown-Dokument verschiedene Ausgabe-Formate zu generieren. Der Standard ist eine html-Ausgabe zum veröffentlichen im Netz. Dies funktioniert sehr sauber und wesentlich besser als mit WYSIWYG-Editoren. Doch auch LaTeX, PDF oder sogar .Doc oder .epub sind als Export möglich. Wenn du also auf der Suche nach einer unkomplizierten Möglichkeit bist, Texte konzentriert zu schreiben, die evtl. in verschiedenen Medien Veröffentlicht werden sollen (Web, Druck), dann ist das erlernen von Markdown eine Lohnenswerte Investition. Und dabei ist es gar nicht schwierig... Wie schreibe ich Markdown? ------------------------------------- Wie funktioniert das nun im genaueren? Anleitungen, wie man in Markdown formatiert, gibt es zuhauf. Hier muss man auch noch unter dem "einfachen" *Markdown* und dem etwas umfangreicheren *Multimarkdown* unterscheiden. Dazu kommen verschiedene "Dialekte" von Markdown, die einzelne Funktionen zusätzlich können oder anders bzw. Eindeutiger auszeichnen (siehe auch [CommonMark][CommonMark]) Multimarkdown lassen sich mehr Auszeichnungen vornehmen, dazu gehören z.B. Tabellen, Fußnoten, etc.. . Hier haben wir die aus unserer Sicht besten Online-Quellen zu dem Thema zusammengestellt. ###Quellen zum Erlernen von Markdown * ist eine deutsche Übersetzung der Original-Dokumentation. Die Informationen sind dementsprechend vollständig, hat aber klar den Fokus auf Web-publishing, also dem Schreiben fürs Internet. Ganz ohne Vorkenntnisse in HTML kann die Doku etwas unübersichtlich sein. * ist die Original-Grundlagen-Info von John Gruber (Engl.) * Hier findet man die Offizielle Beschreibung von GitHub-Markdown. Dieses kann ein wenig mehr als das normale Markdown, dies ist aber in der Dokumentation erkenntlich (Engl.). * Schönes Schritt für schritt Tutorial unter (Engl.) * Immer einen Blick wert - Die Wikipedia-Seite zu Markdown: [Wikipedia Markdown][Wikimd] ###Quellen zum Erlernen von Multimarkdown: * Hier ein nettes Multimarkdown Cheatsheet: (Engl.) * Dies ist die Original-Dokumentation von Multimarkdown [Multimarkdown Doku](https://github.com/fletcher/MultiMarkdown/wiki/MultiMarkdown-Syntax-Guide) ###Merkblatt Wir haben hier zur Übersicht ein Cheat-Sheet mit den wichtigsten Funktionen von Markdown zusammengestellt: ~~~ # Überschrift 1 ## Überschrift 2 ### Überschrift 3 #### Überschrift 4 Ein normaler Absatz wird mit einer Leerzeilen davor abgetrennt. *ein Stern vor und nach Bereich macht kursiv* und **Zwei Sterne machen fett**. Ein Zeilenumbruch geht mit drei Leerzeichen. > Ein Zitat wird mit dem Pfeil markiert. > Dann wird es etwas eingerückt * Aufzählung * geht mit Stern * und Leerzeichen 1. Nummerierung 2. geht mit 3. Zahlen und Punkt 4. und Leerzeichen ![Alt-Text für eine Abbildung](NameDesBildes.jpg) [Bezeichnung für einen Link](http://www.urlEinesLinks.html) Code-Blöcke werden mit vier Leerzeichen (tab) vor der Zeile markiert. So kann man dann alle Zeichen verwenden, die sonst für Markdown etwas bedeuten. ~~~ Ein weiteres, umfangreicheres und schön übersichtliches Merkblatt hier: [Mac&i Markdowwn-Cheatsheet](http://www.heise.de/mac-and-i/downloads/65/1/1/6/7/1/0/3/Markdown-CheatSheet-Deutsch.pdf). ###Noch mehr als Multimarkdown Alles, was selbst Multimarkdown nicht kann, kann in den Text per *html-Code* eingefügt werden. Das bedingt allerdings etwas mehr Vorwissen, was hier den Rahmen sprengen würde. Aber diejenigen, die von html bereits Ahnung haben, können dies nutzen. *Formeln* können in einigen Markdown-Editoren per TeX-Code eingefügt werden. Beispiel: When $a \ne 0$, there are two solutions to $(ax^2 + bx + c = 0)$ and they are $$x = {-b \pm \sqrt{b^2-4ac} \over 2a}.$$ Jetzt wo wir wissen, wie man Dokumente in Markdown schreiben kann, wäre es noch gut zu wissen, mit welchem Programm man diese Texte sinnvollerweise schreiben sollte. Hilfreiche Editoren ------------------------- Prinzipiell kann zum Schreiben von Markdown jeder Texteditor benutzt werden. Es gibt jedoch Editoren, die Markdown-Auszeichnungen "verstehen" und während der Eingabe oder in einer Vorschau die Formatierungen anzeigen. Ebenso unterscheiden sich die Editoren bei der Vollständigkeit von (Multi-)Markdown und den Export-Formaten. Hier eine Übersicht beliebter und brauchbarer Editoren. Texteditoren: * [Notepad++] (http://notepad-plus-plus.org/) (WIn), [md-Plugin](https://github.com/Hyzual/markdown_npp) für Notepad++ * [Textwrangler](http://www.barebones.com/products/textwrangler/) (OSX), [Anleitung](http://cantus.us/using-markdown-in-textwrangler/) für Textwrangler * [Sublimetext](http://www.sublimetext.com/) (Win, OSX) Trial ist dauerhaft kostenfrai, [md-Erweiterung](https://packagecontrol.io/packages/MarkdownEditing) für Sublimetext * [Textastic](http://www.textasticapp.com/) (iOS) * [DroidEdit](http://www.droidedit.com/) (Android) Spezielle Markdown Editoren: * [Writemonkey](http://writemonkey.com/) (Win) * [MarkdownPad](http://markdownpad.com/) (Win) * [MacDown](http://macdown.uranusjr.com/) (OSX) * [Byword](http://bywordapp.com/) (OSX, iOS) * [Multimarkdown Composer](http://multimarkdown.com/) (Mac) * [Writeily](https://play.google.com/store/apps/details?id=com.jmartin.writeily&hl=de) (Android) * [Jotterpad](https://play.google.com/store/apps/details?id=com.jotterpad.x&hl=de) (Android) * [StackEdit](https://stackedit.io/) (Online) * [Dillinger](http://dillinger.io/) (Online) Notiz-Anwendungen * [capsa](https://play.google.com/store/apps/details?id=com.runawaybits.capsaandroid.lite) (Android) * [Notebooks](http://www.notebooksapp.com/) (Win/OSX/iOS) Hier gibt es auch noch andere Übersichten mit genaueren Beschreibungen der Anwendungen * [Übersicht Windows: ](http://www.maketecheasier.com/best-markdown-editor-for-windows/) * [Übersicht Mac][Mac&i] * [noch eine Übersicht Mac](http://mac.appstorm.net/roundups/productivity-roundups/35-markdown-apps-for-the-mac/) Zum ersten ausprobieren bietet sich ein Online-Editor an, da man dafür nichts installieren muss. Welche Anwendung langfristig am besten zu dem persönlichen Geschmack passt, muss jeder für sich selbst herausfinden. Mache Anwendunge bieten direkt einen passenden Export in Formate wie .rtf, .epub etc. (z.B. Multimardown Composer oder Byword). Einen Export in .html bieten alle, .pdf die meiseten auch. Manche Anwendungen kosten ein paar Euro, hier sollte man genau schauen, ob die zusätzlichen Features dies auch wert sind. > Write Markdown! [Dieser Text als Markdown-Dokument](Markdown_Tutorial.txt) [Mac&i]: http://www.heise.de/mac-and-i/artikel/Schreiben-mit-Markdown-am-Mac-und-unter-iOS-2105025.html [CommonMark]: http://commonmark.org/ [Wikimd]: http://de.wikipedia.org/wiki/Markdown ---