IT-Berufe-Podcast

Plain-Text-Markup-Formate für Texte (Markdown, Asciidoc) – IT-Berufe-Podcast #155


Listen Later

Um die Vorteile und Einsatzgebiete von Plain-Text-Markup-Formaten für längere Texte geht es in der einhundertfünfundfünfzigsten Episode des IT-Berufe-Podcasts.

Inhalt

Plain-Text-Formate sind Formate, die in reinen (menschenlesbaren) Text-Dateien abgelegt werden, also keine binären Formate wie z.B. in Microsoft Word oder LibreOffice.

Vorteile von Plain-Text-Formaten
  • Versionierung: Diff, Merge, Branches möglich
  • Langlebigkeit: Keine proprietäre Bearbeitungssoftware nötig, keine Abhängigkeit von Herstellern
  • Produktivität: Arbeit ausschließlich mit der Tastatur ohne Maus
  • Flexibilität: Konvertierbar, zur Not selbst parsbar, mit jedem beliebigen Editor änderbar
  • Automatisierung: Mächtige Tools zur Manipulation vorhanden
  • Beispiele für Formate
    • Markdown
      • leicht zu lernen, geringer Sprachumfang
      • Output hauptsächlich HTML
      • breite Unterstützung in Tools, z.B. WordPress, GitHub
      • AsciiDoc
        • sehr großer Sprachumfang, sogar geeignet für Bücher
        • viele verschiedene Output-Formate, z.B. HTML, PDF, EPUB
        • gut in übliche Build-Prozesse integriert, z.B. in Gradle
        • Textile
          • ähnelt der Wiki-Syntax
          • Redmine
          • LaTeX
            • komplettes Textsatz-System, „perfekter“ Textsatz
            • geeignet für komplette Bücher inkl. Verzeichnissen, Index, Literaturverzeichnis
            • PlantUML
              • Gestaltung von UML-Diagrammen
              • kann u.a. in LaTeX und AsciiDoc eingebunden werden, aber auch in Wikis
              • Tools
                • Pandoc: Konvertiert automatisch Dateien zwischen beliebigen Formaten
                • VSCode: Editor für beliebige Markup-Formate inkl. Preview-Funktion
                • MarkdownPad: Editor für Markdown
                • Quelltextbeispiele

                  Es folgen Beispiele für das gezeigte HTML-Fragment in den unterschiedlichen Markup-Sprachen.

                  HTML
                  Markup-Sprachen: HTML

                  Ein normaler Absatz in HTML.

                  Überschrift

                  Fetter Text und kursiver Text.

                  Listen
                  • Ungeordnete Liste
                    • Mit Unterpunkten
                    • Noch ein Unterpunkt
                    • Noch ein Punkt
                      1. Geordnete Liste
                        1. Mit Unterpunkten
                        2. Noch ein Unterpunkt
                        3. Noch ein Punkt
                        4. Links

                          IT-Berufe-Podcast

                          Bilder
                          Bildbeschreibung
                          Code

                          Inline Code mit code.

                          public static void main(String[] args) {
                          System.out.println("Hallo!");
                          }
                          Zitate

                          Zitate sehen so aus.

                          Markdown
                          # Markup-Sprachen: Markdown
                          Ein normaler Absatz in Markdown.
                          ## Überschrift
                          **Fetter Text** und *kursiver Text*.
                          ## Listen
                          * Ungeordnete Liste
                          * Mit Unterpunkten
                          * Noch ein Unterpunkt
                          * Noch ein Punkt
                          1. Geordnete Liste
                          1. Mit Unterpunkten
                          2. Noch ein Unterpunkt
                          2. Noch ein Punkt
                          ## Links
                          [IT-Berufe-Podcast](https://it-berufe-podcast.de "Website des IT-Berufe-Podcasts")
                          ## Bilder
                          ![Bildbeschreibung](https://it-berufe-podcast.de/Abbildungen/LogoITBerufePodcast500px.jpg "Das Logo des IT-Berufe-Podcasts")
                          ## Code
                          Inline Code mit `code`.
                          \```java
                          public static void main(String[] args) {
                          System.out.println("Hallo!");
                          }
                          \```
                          ## Zitate
                          > Zitate sehen so aus.
                          AsciiDoc
                          == Markup-Sprachen: AsciiDoc
                          Ein normaler Absatz in AsciiDoc.
                          === Überschrift
                          *Fetter Text* und _kursiver Text_.
                          === Listen
                          * Ungeordnete Liste
                          ** Mit Unterpunkten
                          ** Noch ein Unterpunkt
                          * Noch ein Punkt
                          . Geordnete Liste
                          .. Mit Unterpunkten
                          .. Noch ein Unterpunkt
                          . Noch ein Punkt
                          === Links
                          https://it-berufe-podcast.de[IT-Berufe-Podcast]
                          === Bilder
                          image:https://it-berufe-podcast.de/Abbildungen/LogoITBerufePodcast500px.jpg[Bildbeschreibung,title="Das Logo des IT-Berufe-Podcasts"]
                          === Code
                          Inline Code mit `code`.
                          [source,java]
                          ----
                          public static void main(String[] args) {
                          System.out.println("Hallo!");
                          }
                          ----
                          === Zitate
                          ____
                          Zitate sehen so aus.
                          ____
                          Textile
                          h1(#markup-sprachen-markdown). Markup-Sprachen: Textile
                          Ein normaler Absatz in Textile.
                          h2(#überschrift). Überschrift
                          *Fetter Text* und _kursiver Text_.
                          h2(#listen). Listen
                          * Ungeordnete Liste
                          ** Mit Unterpunkten
                          ** Noch ein Unterpunkt
                          * Noch ein Punkt
                          # Geordnete Liste
                          ## Mit Unterpunkten
                          ## Noch ein Unterpunkt
                          # Noch ein Punkt
                          h2(#links). Links
                          "IT-Berufe-Podcast":https://it-berufe-podcast.de
                          h2(#bilder). Bilder
                          !https://it-berufe-podcast.de/Abbildungen/LogoITBerufePodcast500px.jpg(Das Logo des IT-Berufe-Podcasts)!
                          Bildbeschreibung
                          h2(#code). Code
                          Inline Code mit @code@.
                          bc(java). public static void main(String[] args) {
                          System.out.println("Hallo!");
                          }
                          h2(#zitate). Zitate
                          bq. Zitate sehen so aus.
                          LaTeX
                          \hypertarget{markup-sprachen-markdown}{%
                          \section{Markup-Sprachen: LaTeX}\label{markup-sprachen-markdown}}
                          Ein normaler Absatz in LaTeX.
                          \hypertarget{uxfcberschrift}{%
                          \subsection{Überschrift}\label{uxfcberschrift}}
                          \textbf{Fetter Text} und \emph{kursiver Text}.
                          \hypertarget{listen}{%
                          \subsection{Listen}\label{listen}}
                          \begin{itemize}
                          \tightlist
                          \item
                          Ungeordnete Liste
                          \begin{itemize}
                          \tightlist
                          \item
                          Mit Unterpunkten
                          \item
                          Noch ein Unterpunkt
                          \end{itemize}
                          \item
                          Noch ein Punkt
                          \end{itemize}
                          \begin{enumerate}
                          \def\labelenumi{\arabic{enumi}.}
                          \tightlist
                          \item
                          Geordnete Liste
                          \begin{enumerate}
                          \def\labelenumii{\arabic{enumii}.}
                          \tightlist
                          \item
                          Mit Unterpunkten
                          \item
                          Noch ein Unterpunkt
                          \end{enumerate}
                          \item
                          Noch ein Punkt
                          \end{enumerate}
                          \hypertarget{links}{%
                          \subsection{Links}\label{links}}
                          \href{https://it-berufe-podcast.de}{IT-Berufe-Podcast}
                          \hypertarget{bilder}{%
                          \subsection{Bilder}\label{bilder}}
                          \begin{figure}
                          \centering
                          \includegraphics{https://it-berufe-podcast.de/Abbildungen/LogoITBerufePodcast500px.jpg}
                          \caption{Bildbeschreibung}
                          \end{figure}
                          \hypertarget{code}{%
                          \subsection{Code}\label{code}}
                          Inline Code mit \texttt{code}.
                          \begin{Shaded}
                          \begin{Highlighting}[]
                          \KeywordTok{public} \DataTypeTok{static} \DataTypeTok{void} \FunctionTok{main}\NormalTok{(}\BuiltInTok{String}\NormalTok{[] args) \{}
                          \BuiltInTok{System}\NormalTok{.}\FunctionTok{out}\NormalTok{.}\FunctionTok{println}\NormalTok{(}\StringTok{"Hallo!"}\NormalTok{);}
                          \NormalTok{\}}
                          \end{Highlighting}
                          \end{Shaded}
                          \hypertarget{zitate}{%
                          \subsection{Zitate}\label{zitate}}
                          \begin{quote}
                          Zitate sehen so aus.
                          \end{quote}
                          PlantUML

                          Und zum Schluss noch ein Beispiel für ein Klassendiagramm in PlantUML.

                          class Auto {
                          hersteller : String
                          farbe : String
                          kilometerstand : Integer
                          neupreis : Double
                          fahre() : void
                          hupe() : void
                          }

                          Gerendert sieht das dann so aus.

                          Literaturempfehlungen

                          Eines meiner absoluten Lieblingsbücher widmet ein eigenes Kapitel dem Thema „Plain Text“: The Pragmatic Programmer*. Dave Thomas und Andy Hunt erklären dir auch noch einmal die Vorteile von einfachen Textdateien.

                          *

                          Links
                          • Permalink zu dieser Podcast-Episode
                          • RSS-Feed des Podcasts
                          • Markdown
                          • AsciiDoc
                          • Textile
                          • LaTeX
                          • PlantUML
                          • Pandoc
                          • Visual Studio Code
                          • MarkdownPad
                          • ...more
                            View all episodesView all episodes
                            Download on the App Store

                            IT-Berufe-PodcastBy Stefan Macke

                            • 5
                            • 5
                            • 5
                            • 5
                            • 5

                            5

                            1 ratings


                            More shows like IT-Berufe-Podcast

                            View all
                            Streitkräfte und Strategien by NDR Info

                            Streitkräfte und Strategien

                            45 Listeners

                            Sternengeschichten by Florian Freistetter

                            Sternengeschichten

                            45 Listeners

                            Geschichten aus der Geschichte by Richard Hemmer und Daniel Meßner

                            Geschichten aus der Geschichte

                            196 Listeners

                            c’t uplink - der IT-Podcast aus Nerdistan by c’t Magazin

                            c’t uplink - der IT-Podcast aus Nerdistan

                            6 Listeners

                            MORD AUF EX by Leonie Bartsch & Linn Schütze

                            MORD AUF EX

                            128 Listeners

                            {ungeskriptet} - Gespräche, die dich weiter bringen by Ben Berndt

                            {ungeskriptet} - Gespräche, die dich weiter bringen

                            23 Listeners