Markdown

Hilfe zum Markdown-Plugin

Text wird auf Open Musik Academy / OMA als Markdown eingegeben. Das heißt, über einfache Sonderzeichen können Sie erreichen, dass Textabschnitte auf eine bestimmte Art formatiert werden (zum Beispiel als Überschriften, Zeilenumbrüche, ungeordnete oder geordnete Listen, als Links, Zitate usw.). Im Folgenden finden Sie die Sonderzeichen, die Sie zum Formatieren von Text verwenden können.

Einfacher Text

Einfacher Text in Markdown

Bei einfachem Text brauchen Sie gar nichts zu beachten: Sie schreiben einfach drauflos wie in einem Office-Dokument und beim Speichern sehen Sie Text mit weichen Umbrüchen (also als normalem Fließtext) und ohne sonstige Formatierungen.

Überschriften

Die Eingabe: # Überschriftsebene 1 wird beim Übersetzen zu einer Überschrift der ersten Ebene. Bitte beachten Sie, dass ein Dokument nur eine einzige Überschrift 1 haben sollte. In der Vorschau (oder dem Speichern und Schließen des Eingabemodus) sieht die Überschrift dann wie folgt aus:

Überschriftsebene 1

Die Eingabe: ## Überschriftsebene 2 wird beim Übersetzen zu einer Überschrift der zweiten Ebene und sieht folgendermaßen aus.

Überschriftsebene 2

Die Eingabe: ### Überschriftsebene 3 wird beim Übersetzen zu einer Überschrift der dritten Ebene:

Überschriftsebene 3

Anmerkung: Aus publikationstechnischer Sicht sind mehr als drei Überschriftsebenen unüblich und in der Regel nicht sinnvoll. Wenn Sie das Gefühl haben, Sie müssten eine vierte Überschriftsebene verwenden (also vier #-Zeichen), sollten Sie Ihre Textgliederung noch einmal überdenken.

Fett, kursiv oder durchgestrichen

Fett, kursiv und durchgestrichen

Um einzelne Wörter oder wichtige Absätze fett oder kursiv zu gestalten, verwenden Sie in Markdown die *-Zeichen, für durchgestrichenen Text können Sie zwei ~~-Zeichen verwenden. Beispiele:

  • ein *-Zeichen um ein Wort oder einen Ausdruck herum (Beispiel: *kursiv*) = kursiv
  • zwei **-Zeichen um ein Wort oder einen Ausdruck herum (Beispiel: **fett**) = fett
  • drei ***-Zeichen um ein Wort oder einen Ausdruck herum (Beispiel: ***fett und kursiv***) = fett und kursiv
  • zwei ~~-Zeichen um ein Wort oder einen Ausdruck herum (Beispiel: ~~durchgestrichen~~ = durchgestrichen

Beispiel: In diesem Satz wurden alle Auszeichnungen für fett und kursiv angewendet, was aus publikationstechnischer Sicht Unsinn ist. Bitte beachten Sie: weniger ist mehr!

Zitate
Listen
Zeilenumbrüche

Anmerkungen zu Zeilenumbrüchen

  • Ein einzelner Zeilenumbruch wird in Markdown ignoriert,
  • Durch zwei Zeilenumbrüche hintereinander bzw. eine Leerzeile entsteht ein neuer Absatz.
  • Im Text werden weiche Zeilenumbrüche (wie in einem Office-Programm) automatisch erzeugt.
  • Einen harten Zeilenumbruch in einem Absatz können Sie durch die Eingabe von drei oder mehr Leerzeichen erzeugen. Nach den gleich folgenden (unsichtbaren) vier Leerzeichen und einem Zeilenumbruch (Enter-Eingabe)
    wurde hier z.B. ein Zeilenumbruch in diesem Listenpunkt-Absatz erzeugt. Da Leerzeichen im Editor nicht zu sehen sind (und nicht jeder gewohnt ist, auf Leerzeichen zu achten), ist diese Markdown-Auszeichnung für die eine oder den anderen ggf. etwas gewöhnungsbedürftig.
Links

Links

Einen Link bzw. einen Verweis können Sie mit der folgenden Auszeichnung erzeugen:

[Linktext](Linkziel "Text, der beim Überfahren mit der Maus angezeigt wird")

Die folgende Eingabe ...

[Zur elmu Startseite...](https://elmu.online "Zur elmu-Website")

... wird nach dem Speichern zu:

Zur elmu Startseite...

Bilder und Medien

Bilder und Medien

Bitte beachten Sie, dass es für die Einbindung von Bildern und Medien Plugins mit besonderer Funktionalität gibt (Bilder-Plugin und Video-Plugin).
Ein Bild können Sie mit einer ganz ähnlichen Syntax wie Links einfügen, nur dass Sie den eckigen Klammern noch ein Ausrufungszeichen voranstellen müssen:

![Alternativtext](Linkziel "Bildtitel")

Das heißt, die folgende Zeile

![Hilfebildchen](cdn://media/p66k6usghjStusMCetr8E3/Hilfesymbol-klein_vCrrNmatFDkQ6uSekNwkCd.png "Hilfebildchen")

wird umgewandelt zu

Hilfebildchen

Anmerkung: Bitte bedenken Sie, dass es für Bilder ein komfortables Plugin gibt. Sie sollten Bilder über Markdown also nur dann verwenden, wenn Sie dafür einen Grund haben.

Mit einer ganz ähnlichen Syntax können Sie sogar Audio- und Video-Dateien in ein Markdown-Textfeld einbinden. Vorausgesetzt, Sie haben in dem Markdown-Plugin die Checkbox Medien wiedergeben angehakt, wird der folgende Ausdruck ...

![](https://cdn.openmusic.academy/media/7DGfsbA6a1QfkTLRm6V8vA/oma-opener-sound-3j77JF4c9mqcQeLdCCSTmN.mp3)

... zu einem Audio-Player:


Der OMA-Opener-Sound ist von Ulrich Kaiser (OMA-Team).

Und die folgende Zeile ...

![Hallo](https://cdn.openmusic.academy/media/cTfhXcxtkgqYLE3k1P6JAR/2022-03-07-opener-cLsXYg2gyFNHKmY6S9CzX5.mp4)

... wird ein Video-Player:

OMA-Logo und Animation sind von der Grafikdesignerin Mani Vieregg (OMA-Team).

Linien
URL's, Mailadressen und Sonderzeichen

Eine URL können Sie zwischen den Pfeilen <> eingeben, z.B.:

<https://elmu.online/> wird zu https://elmu.online/

Mit der gleichen Syntax werden auch Mailadressen angegeben, z.B.:

<kontakt@elmu.online> wird zu kontakt@elmu.online

Wenn im Vorangegangenen Markdown-Auszeichnungen erläutert worden sind, konnten Sie die Markdown-Sonderzeichen im Text sehen, ohne dass diese in HMTL umgewandelt wurden. Dass Sonderzeichen von Markdown wie normaler Text behandelt werden, lässt sich durch den Backslash \ oder die Back-Ticks `` erreichen (die Back-Ticks erhalten Sie durch die ⇧-Umschalttaste, die Gravis- bzw. Akzent-Taste und ein Leerzeichen). Zum Beispiel wird

\# Überschrift oder
`#` Überschrift

nicht zu einer Überschrift, sondern zu einem #-Zeichen und einem normalen Text:

# Überschrift

License: CC BY-SA 4.0 (any later version)
Source: elmu.online, Article “Markdown”, https://elmu.online/docs/kCAdtKBPWnU4kjYwBaqMgn/hilfe-markdown, 05/18/2022, 2:22 AM
Contributions by: Ulrich Kaiser

This website uses cookies that are technically needed for strictly functional aspects of the website. These cookies neither track your activities, nor provide 3-rd parties with information of any kind about your visit. By clicking accept you acknowledge this and give your express consent to the usage of the cookies.

Users of our platform are able to embed external content via plugins such as a YouTube video player. By clicking on "accept" you will confirm that you have no objections to embedded external content.

When saving text in a document or uploading files to our server, these will be published under the standard licence of this platform: CC BY-SA 4.0 or any later version (unless there is a different CC licence given in those files). By clicking on "accept" you will agree to these terms.