Wie viele Zeichen benötigen AsciiDoc, Markdown und LaTeX?
Bei der Erstellung von technischen Unterlagen kommt es oft darauf an, wie viele Zeichen für die Standardformatierung erforderlich sind.
In diesem Artikel vergleichen wir AsciiDoc, Markdown und LaTeX anhand der Anzahl der Zeichen, die für die grundlegende Formatierung benötigt werden, und gehen dabei auch auf einige der Einschränkungen von Markdown ein.
Für den Zeichenvergleich werden wir alle erforderlichen Zeichen einbeziehen. Dazu können auch Leerzeichen gehören (z. B. bei Listen). Werfen wir zunächst einen Blick auf die Ergebnisse:
1. Setup
AsciiDoc: Kein setup benötigt.
Markdown: Kein setup benötigt.
LaTeX: Erfordert eine umfangreiche Einrichtung, mit mindestens 101 Zeichen, um das Dokument mit
\documentclass{article},\usepackage{hyperref}sowie\begin{document}&\end{document}zu initialisieren. Bei der grundlegenden Verwendung von LaTeX fallen Kosten für die Einrichtung an, die weder bei AsciiDoc noch bei Markdown anfallen.
2. Überschriften & Unterüberschriften
Die Überschriften in allen drei Sprachen sind recht einfach:
Überschrift:
AsciiDoc:
=(1 Zeichen)Markdown:
#(1 Zeichen)LaTeX:
\section{}(10 Zeichen)
Unterüberschriften:
AsciiDoc:
==(2 Zeichen)Markdown:
##(2 Zeichen)LaTeX:
\subsection{}(13 Zeichen)
3. Grundlegende Textformatierung: Fett, kursiv, unterstrichen
Die Formatierung von fett, kursiv und unterstrichen variiert in der Zeichenlänge:
Fett:
AsciiDoc:
*...*(2 Zeichen)Markdown:
**...**(4 Zeichen)LaTeX:
\textbf{...}(9 Zeichen)
Kursiv:
AsciiDoc:
_..._(2 Zeichen)Markdown:
*...*(2 Zeichen)LaTeX:
\textit{...}(9 Zeichen)
Unterstrichen:
AsciiDoc:
[.underline]#...#(14 Zeichen)LaTeX:
\underline{...}(15 Zeichen)
Das Unterstreichen von Text ist das erste Beispiel dafür, dass Markdown weitere Erweiterungen (auch Dialekte oder Flavors genannt) benötigt, um unterstrichenen Text darzustellen, da dies nicht von Haus aus unterstützt wird.
Hier sind drei Möglichkeiten, Text in Markdown zu unterstreichen, basierend auf verschiedenen Ansätzen und Dialekten:
1. HTML-Tags verwenden:
Sie können HTML-Tags direkt in Markdown einbetten, um Text zu unterstreichen: <u>...</u>
HTML-Tags werden von den meisten Markdown-Dialekten wie GitHub-Flavored Markdown und CommonMark unterstützt.
2. Unterstreichen mit den Markdown-Erweiterungen von Pandoc:
In Pandoc können Unterstreichungen mit speziellen Erweiterungen vorgenommen werden: [...]{.underline}
3. Unterstreichen mit CSS:
Sie können Inline-CSS anwenden, um Text in Markdown zu unterstreichen: <span style="text-decoration:underline;">...</span>
Jede Methode stützt sich auf bestimmte Markdown-Dialekte oder Renderer, also prüfen Sie, welche zu Ihrer Umgebung passt. Diese Umgehungslösungen erfordern 7 (HTML-Tags), 14 (Pandoc) oder 48 (CSS) Zeichen, um unterstrichenen Text anzuzeigen.
Technisches Schreiben auf Mac, iPad & iPhone
4. Listen (in erster und zweiter Ebene)
Die Handhabung von Listen in diesen Sprachen:
AsciiDoc:
* ...für eine Liste in erster Ebene und** ...für eine Liste in zweiter Ebene (insgesamt 5 Zeichen)Markdown:
* ...für eine Liste in erster Ebene und- ...für eine Liste in zweiter Ebene (insgesamt 6 Zeichen)LaTeX:
\begin{itemize}
\item ...
\subitem ...
\end{itemize}(insgesamt 50 Zeichen)
5. Links und Bilder
Sowohl Links als auch Bilder sind für die Dokumentation von entscheidender Bedeutung:
Links:
AsciiDoc:
www.test.com[...](2 Zeichen)Markdown:
[...](www.test.com)(4 Zeichen)LaTeX:
\href{www.test.com}{...}(9 Zeichen)
Bilder:
AsciiDoc:
image:...[](8 Zeichen)Markdown:
(11 Zeichen)LaTeX:
\includegraphics[...]{...}(38 Zeichen)
Gesamtzahl der Zeichen im Vergleich
Zählen wir die insgesamt für diese Elemente verwendeten Zeichen zusammen. Wir vergleichen die Tags mit und ohne Setup, sowie mit und ohne Unterstreichung, die Markdown-Dialekte erfordert:
Ohne Setup:
AsciiDoc: 36 Zeichen
Markdown: mindestens 37 Zeichen (mit HTML Tags zum Unterstreichen)
LaTeX: 153 Zeichen
Mit Setup:
AsciiDoc: 36 Zeichen
Markdown: mindestens 37 Zeichen (mit HTML Tags zum Unterstreichen)
LaTeX: 254 Zeichen
Ohne Unterstreichung und Setup:
AsciiDoc: 22 Zeichen
Markdown: 30 Zeichen
LaTeX: 138 Zeichen
Fazit: Leichte Auszeichnungssprachen haben ihren Namen wirklich verdient
Was die reine Zeichenzahl betrifft, so benötigt AsciiDoc weniger Zeichen als Markdown und LaTeX. Vor allem LaTeX, obwohl leistungsstark, ist viel ausschweifender. Jede Sprache hat ihre Stärken, abhängig von Ihren Bedürfnissen, aber in Bezug auf Kürze und Benutzerfreundlichkeit glänzt AsciiDoc in diesem Vergleich.
Markdown ist aufgrund seiner Einfachheit und Benutzerfreundlichkeit zweifelsohne eine der beliebtesten Auszeichnungssprachen. Die Eleganz von Markdown hat jedoch ihren Preis: begrenzte Unterstützung von Funktionen ohne Erweiterungen.
Wie im Vergleich erwähnt, ist Unterstreichen in der Standardversion von Markdown nicht möglich. Ebenso ist die native Unterstützung von Markdown für komplexe Funktionen wie Tabellen, Fußnoten und die Ausrichtung von Text und Bildern minimal oder nicht vorhanden, sodass Erweiterungen wie GitHub Flavored Markdown oder Pandoc Markdown erforderlich sind. Während Markdown grundlegende Formatierungen mit Leichtigkeit bewältigen kann, wird bei der Erstellung fortgeschrittener oder strukturierter Dokumente (z. B. mit komplexen Tabellen, benutzerdefinierter Nummerierung in Listen oder detaillierter Bildplatzierung) schnell klar, dass Markdown allein nicht ausreicht. Die Benutzer greifen oft zu anderen Dialekten, Plugins oder zur Einbettung von HTML, um ihre Ziele zu erreichen.
Zusammenfassend lässt sich sagen, dass AsciiDoc einen goldenen Mittelweg bietet, indem es die Prägnanz von Markdown mit den fortgeschrittenen Möglichkeiten von LaTeX kombiniert und damit eine gute Wahl für die technische Dokumentation ist, ohne dass Erweiterungen erforderlich sind.
Haben wir Ihr Interesse geweckt? Dann schauen Sie sich gerne adoc Studio an. Mit unserer App organisieren, schreiben und exportieren Sie AsciiDoc Dokumente im Handumdrehen.
