Abschlag

Markdown-Tutorial - Vom Setup zur Syntax

Markdown-Tutorial - Vom Setup zur Syntax
Markdown ist eine leicht zu lesende und leicht zu erlernende Auszeichnungssprache. Im Gegensatz zu HTML, XML oder anderen Markup-Sprachen, bei denen es durch die wahnsinnige Anzahl undurchsichtiger Tags unzugänglich erscheint, ist Markdown selbst als Rohtextdatei gut lesbar read.

Gleichzeitig ist Markdown sehr leicht und flexibel. Der beliebteste Anwendungsfall für Markdown sind Lizenz- und README-Dateien in einem GitHub-Repository, aber es wird auch in immer mehr CMS integriert, um Blog-Posts zu verwalten und sogar Forschungsarbeiten zu schreiben. Sie können mathematische Gleichungen mit Plugins für LaTeX rendern.

Es wird jedoch hauptsächlich von Entwicklern verwendet. Es ist sehr hilfreich bei der Erstellung von Tutorials und Dokumentationen dank Syntax-Highlighting für mehrere Sprachen und Unterstützung für Bilder und sogar Gifs.

Beginnen wir mit einem Setup, das uns eine Vorschau des gerenderten Dokuments neben einer rohen Markdown-Textdatei ermöglicht.

Atom-Texteditor und Markdown-Vorschau

Sie können Atom Text Editor oder Visual Studio Code herunterladen und installieren, um mitzumachen. Atom und VS Code haben beide vorinstallierte Plugins für Markdown Preview. Hier wird Atom verwendet, aber die Syntax würde ungefähr gleich bleiben, egal welchen Texteditor Sie verwenden.

Stellen Sie auf Atom sicher, dass das Markdown Preview-Paket aktiviert ist (es ist tatsächlich standardmäßig aktiviert). Erstellen Sie einen Ordner für dieses Markdown-Tutorial und öffnen Sie dort eine neue Datei (STRG + N) und geben Sie dort den folgenden Text ein.

# Dies ist eine Überschrift
___
##Dies ist auch eine Überschrift
Hier ist ein Text

Speichern Sie die Datei (STRG + S) mit a .md-Erweiterung. Sie können Ihre Datei beispielsweise als test . benennen.md und die .md-Teil teilt Atom mit, dass dies eine Markdown-Datei ist und die Erweiterung wie vorgesehen damit funktionieren würde. Sie können eine Vorschau erstellen, indem Sie die folgende Tastenkombination verwenden (STRG+UMSCHALT+M), die in einem neuen Fenster neben der Rohtextdatei angezeigt wird.

Sie können den Vorschaubereich schließen, indem Sie dieselbe Tastenkombination verwenden oder die GUI selbst verwenden using.

Wenn alles eingerichtet ist, können wir uns die Syntax genauer ansehen und im Handumdrehen erstaunliche Dokumente erstellen.

Markdown-Syntax

Wie bereits erwähnt, ist die Hauptmotivation von Markdown die Lesbarkeit. Dies bedeutet, dass keine undurchsichtigen Tags oder verschachtelten Tags oder andere verwirrende Zeichenfolgen auftreten. Stattdessen können wir mit einem '#'-Symbol beginnen, um anzuzeigen, dass diese bestimmte Zeile eine Überschrift ist.

# Ist eine Überschrift.
## Zeigt auch Überschrift an, jedoch mit kleinerer Schriftgröße.
###Sie können zu fortlaufend kleineren Größen übergehen

Zeilenumbrüche

Markdown fasst weiterhin den gesamten Text in einen riesigen Absatz zusammen, selbst wenn der Rohtext in mehrere verschiedene Zeilen unterteilt ist. Um dies abzumildern, können Sie am Ende einer Zeile zwei Leerzeichen verwenden und dann ein Zeilenumbruchzeichen einfügen (d. h. Hit ) oder verwenden Sie einfach zwei Zeilenumbrüche für einen etwas anderen Effekt, wie unten gezeigt.

Der Satz „Was ist warum…“ begann in einer neuen Zeile, ist aber nicht von der vorherigen Zeile getrennt, während die Verwendung von zwei Zeilenumbrüchen eine größere Trennung erzeugte.

Horizontale Regel

Wie der Name schon sagt, erstellt eine horizontale Linie eine horizontale Linie, mit der Sie Ihr Dokument strukturieren und logische Trennungen vornehmen können. Es gibt zwei Methoden zum Erstellen einer horizontalen Linie. Die erste besteht darin, drei oder mehr Unterstriche zu verwenden, um eine horizontale Linie zu erstellen.

#Überschrift 1
___
Absatz und Überschrift werden durch eine horizontale Linie getrennt.
___
Ein weiterer abgetrennter Abschnitt

Eine andere Option (die ich nicht empfehlen werde) ist die Verwendung von drei oder mehr Bindestrichen '-', aber sie werden auch verwendet, um anzuzeigen, dass der Satz direkt darüber eine Überschrift ist. Wenn Sie also keinen Zeilenumbruch zwischen einem Satz und der darunter liegenden horizontalen Linie haben, hat dieser Satz die Form einer Überschrift.

Kursiv, Fett und Durchgestrichen

Die Syntax für die drei ist ziemlich einfach und spricht für sich.

**Dies ist fett**
__Das ist auch fett__
_Das ist kursiv_
*Dies ist auch kursiv*
~~Das ist durchgestrichen~~

Escape-Zeichen

Nun könnte man sich fragen, wie würdest du buchstäblich **etwas Text** in die endgültige Markdown-Datei schreiben, wenn es einfach jedes Mal fett wird. Dies ist etwas, mit dem sich auch die meisten Programmiersprachen befassen, und die Lösung ist ähnlich wie bei diesen - Verwenden Sie einen umgekehrten Schrägstrich. Dies funktioniert auch für andere Syntaxelemente und ist nicht speziell für Fettdruck geeignet.

\**Dies ist nicht mehr fett\**
Wenn Sie das Backslash-Zeichen selbst anzeigen möchten, verwenden Sie zwei davon und so weiter.
\\ Wird als einzelner Schrägstrich angezeigt

Blockquotes und Codeblöcke

Blockquotes und Codeblöcke sind viel einfacher. Ein Blockquote kann verwendet werden, um einen wichtigen Punkt hervorzuheben, auf den Sie die Aufmerksamkeit der Leser lenken möchten. Dies kann erreicht werden, indem man zu Beginn eine rechte Winkelklammer verwendet, wie gezeigt.

# Überschrift 1
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut
labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris
nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate
velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
> Dies ist eine übersichtliche Zusammenfassung eines Unterabschnitts Ihres Dokuments. A > paar Zeilen, die stehen
vom Rest des Inhalts abheben.
Der Inhalt geht weiter.

So sieht es aus, wenn es gerendert ist.

Bei Codeblöcken rücken Sie einfach die Zeilen die Zeilen um 4 Leerzeichen oder mehr ein. Das ist wirklich

praktisch für Entwickler und Betreiber, die ihre Arbeit dokumentieren möchten. Wir würden später sehen, wie wir das noch besser machen können.

Hyperlinks und Bilder

Für Hyperlinks ist die Syntax ziemlich einfach. Der sichtbare Text wird in eckigen Klammern geschrieben und die URL, auf die er zeigt, wird in runden Klammern direkt daneben geschrieben.

Bei Bildern ist die Syntax ähnlich, außer dass sie mit einem Ausrufezeichen beginnt. Es steht Ihnen frei, einen relativen Pfad in Ihrem Projektordner zu verwenden, der auf das Bild verweist, oder Sie können eine öffentliche URL verwenden.

## Veranschaulichung der HyperLink- und Bildsyntax
___
Sie sollten [uns besuchen](https://linuxhint.com) öfter
So werden Bilder eingebettet.
![SmugPug](https://upload.wikimedia.org/wikipedia/commons/d/d2/Bonny_Bonita.JPG)

Tabellen

Das Erstellen von Tabellen im Markdown beinhaltet buchstäblich das Zeichnen eines ASCII-Porträts (Unicode, um genau zu sein) einer Tabelle.

## Tabellen
 
| Spalte 1  | Spalte 2  | Spalte 3  |
| --------- | --------- | --------- |
| Erste Reihe | Erste Reihe | Erste Reihe |
| Zweite Reihe| Zweite Reihe| Zweite Reihe|

Die Syntax muss nicht genau von einer Zeile zur anderen ausgerichtet sein, aber das Pipe-Zeichen wird verwendet, um in die nächste Spalte zu wechseln und die nächste Zeile zeigt an, dass die nächste Zeile im Allgemeinen begonnen hat.

Erweiterter Abschlag

Für alle, die schon so weit gekommen sind, hier ist der wahre Leckerbissen. Wenn Sie Atom verwenden, können Sie das Markdown Preview-Plugin tatsächlich durch Markdown Preview Plus ersetzen. Welches bietet die folgenden Funktionalitäten.

1.   Mathematische Gleichungen mit LaTeX:

Sie können tatsächlich LaTeX-Skripte zwischen Dollarzeichen einfügen und es wird als LaTeX-Skript gerendert und in der Vorschau mit STRG+UMSCHALT+X-Tastenkombination angezeigt. Du musst nicht einmal alle LaTeX-Kenntnisse kennen, ein paar Schnipsel reichen aus.

## Illustrieren von LaTex
___
$$|\Psi\rangle = \alpha|0\rangle + \beta| \rangle $$

2. Satzstellung markieren

Anstatt Einrückungen zu verwenden, um Codeblöcke anzugeben, können Sie tatsächlich Backticks gefolgt von den Namen der Sprachen verwenden, in denen Ihr Skript angeblich geschrieben ist. Die Sprachen, deren Syntax unterstützt wird, sind zu zahlreich, um sie hier aufzulisten, aber hier ist ein Beispiel in Python.

## Syntax-Highlighting illustrieren
___
"Python
importiere das
def my_function():
print("Hallo Welt!")
zurück 0
"

Es gibt viele Geschmacksrichtungen oder Markdown. GitHub hat sein eigenes spezielles Gebräu und die Syntax ist sehr flexibel. Dies soll die Benutzer nicht einschüchtern, sondern einer größeren Vielfalt von ihnen gerecht werden. Es ist eine dieser Sprachen, bei denen man nur eine Teilmenge versteht, die man braucht, und sie verwendet, anstatt sich mit den technischen Details zu beschäftigen (es sei denn, Sie interessieren sich für die technischen Details)!)

So installieren Sie League of Legends auf Ubuntu 14.04
Wenn Sie ein Fan von League of Legends sind, dann ist dies eine Gelegenheit für Sie, League of Legends zu testen. Beachten Sie, dass LOL von PlayOnLin...
Installieren Sie das neueste OpenRA-Strategiespiel auf Ubuntu Linux
OpenRA ist eine Libre/Free Real Time Strategy Game Engine, die die frühen Westwood-Spiele wie den Klassiker Command & Conquer: Red Alert Red nachbilde...
Installieren Sie den neuesten Dolphin Emulator für Gamecube & Wii unter Linux
Mit dem Dolphin Emulator können Sie Ihre ausgewählten Gamecube- und Wii-Spiele auf Linux-Personalcomputern (PC) spielen. Als frei verfügbarer Open-So...