Markdown (I)

• Schlanke Syntax zum Markup von Text-Dokumenten
• “Erfunden” und spezifiziert 2004
• Inspiriert von “Email-Syntax aus vor-HTML-Zeiten”
• Urheber: John Gruber und
  Aaron “The Internet’s Own Boy” Swartz (†)

Markdown (II)

Markdown (III)

• John Gruber zeigte sich störrisch, was den Einbau zusätzlicher Features betraf:
  es kommt daraufhin zur Entwicklung zahlreicher Erweiterungen vieler z.T. unvereinbarer Markdown-Dialekte

Markdown (IV)

Syntax: Zwölf bis fünfzehn Grund-Regeln erfüllen bereits 90% aller Bedürfnisse:

Markdown (V)

Syntax, Grund-Regeln, Fortsetzung:

Markdown (VI)

Syntax, Grund-Regeln, Fortsetzung:

• Beispiel: Tabellen sind praktisch “ASCII-Art” (hier Methode simple_table):

  +-----------+---------+--------+
  | Sorte     | Preis   | Vorrat |
  +===========+=========+========+
  | Bananen   | 2,97 €  | nein   |
  +-----------+---------+--------+
  | Erdbeeren | 1,49 €  |  ja    |
  +-----------+---------+--------+
  | Himbeeren | 3,11 €  |  ja    |
  +-----------+---------+--------+

Markdown (VII)

• gerenderte Tabelle:
   

Markdown (VIII)

• Beispiel: Listen sind ebenfalls ganz leicht. Verschachteln von Listen durch Einrücken um jeweils 4 Leerzeichen pro zusätzlicher Ebene:

1. eins
1. zwei
    i. römisch 1
    i. römisch 2
        * etwas
        * was anderes
    i. römisch 3
1. drei

Markdown (IX)

“Schweizer Offiziersmesser zur Konvertierung von Dokumenten-Formaten” (I)

“Schweizer Offiziersmesser zur Konvertierung von Dokumenten-Formaten” (II)

Darstellung ohne Vergleich aus Rüstungs-Industrie (I)

Darstellung ohne Vergleich aus Rüstungs-Industrie (II)

Geschichtliches zu Pandoc

Pandoc: Input-Formate (I)

Pandoc kann als INPUT nicht nur Markdown (alle Dialekte, inkl. CommonMark) verarbeiten, sondern auch:

• DocBook

• EPUB

• HTML (mit Einschränkungen)

• JSON

• LaTeX (mit Einschränkungen)

Pandoc: Input-Formate (II)

weiter: mögliche Pandoc-Eingabe-Formate

• MediaWiki

• orgmode

• reStructuredText

• tags2text

• TWiki

• textile

• DOCX (!!!)

Pandoc: Ausgabe-Formate

Ausgabe-Formate von Pandoc außer als Input-Formate gelistete – nämlich: Markdown-Dialekte, DocBook, EPUB/EPUB3, HTML, JSON, LaTeX, MediaWiki, orgmode, reStructuredText – auch:

• ASCIIdoc
• PDF-Folien: Beamer, wie diese (?) Präsentation
• HTML-Folien: RevealJS, wie diese (?) Präsentation; S5; Slidy; Slideous; DZSlides
• ODT (LibreOffice/OpenOffice)
• DOCX
• DokuWiki
• ICML (InDesign!!)
• RTF
• texinfo
• manpages (GROFF)

Zugabe: Mathe- und Formel-Satz

• Per Kommandozeilen-Zusatz. Mehrere Möglichkeiten:

• --gladtex, --jsmath, --katex, --latexmathml, --mathjax, --mathml, --mimetex oder --webtex.
  (falls --mathml: funktioniert nicht in Chrome, nur in Firefox)

Zugabe: Zitate und Bibliografien

    --bibliography=/path/to/my.bib      \
    --csl=/path/to/my.csl               \
    --filter=/path/to/pandoc-citeproc   \