Dies ist mein Testdokument für Markdown. Ich packe hier einfach alle denkbaren Konstrukte in Markdown rein, damit ich nicht immer wieder neu suchen muß.
Den dazugehörigen Markdown-Code findet man im Redmine-Projektarchiv als Quelltext.
Quellen:
- DaringFireball – (besser lesbare lokale Kopie davon)
- PHP Markdown Extra – (für Tabellen)
Überschriften
1 2 3 4 5 |
|
alternativ:
1 2 3 4 5 |
|
Hinweis: Automatisches Nummerieren der Überschriften funktioniert nur in der “Raute-Darstellung” (s. Tests)
Unsortierte Liste
1 2 3 4 5 6 7 8 9 10 11 12 |
|
ergibt:
- Eine Liste
- Geschachtelte Liste
- Formatierungen
- fett
- fett
- fett
- fett
- Kommando:
ls -l
Liste mit Code-Block:
cd /tmp ls
Sortierte Liste
1 2 3 4 5 6 |
|
ergibt:
- Erster Listenpunkt
- Zweiter Listenpunkt
- Erster “Unterpunkt”
- Zweiter “Unterpunkt”
- Dritter “Unterpunkt”
- Dritter Listenpunkt
Bild
1
|
|
ergibt:
Ein Bild:
Absatz- und Zeilenformatierung
So geht
ein fester Zeilenumbruch: Zwei oder mehr Leerzeichen am Zeilenende hinzufügen.
Und nach mind. einer Leerzeile beginnt ein neuer Absatz.
Zeichen maskieren
1
|
|
ergibt:
*Von Sternchen umgeben*
Links
1 2 |
|
ergibt:
Horizontale Linien
3 od. mehr Bindestriche oder Sternchen allein auf einer Zeile:
1 2 3 4 5 6 7 8 9 |
|
ergibt jeweils eine horizontale Linie:
Programmcode
Programmcode wird mit Backticks begrenzt, z.B.
1
|
|
ergibt:
- Benutze die Funktion
printf()
um Text auszugeben.
1
|
|
ergibt:
irgendwo hier (`) ist ein Backtick versteckt.
Mehrzeiliger Programmcode wird um mind. 4 Leerzeichen oder 1 Tab eingerückt:
schon wird es zum einfachen Codeblock.
einfacher Codeblock
public class HelloWorld
{
public static void main(String[] args)
{
System.out.println("HelloWorld");
}
}
Schöner sieht allerdings ein formatierter Codeblock aus (vgl. Octopress-Erweiterungen).
Octopress-Erweiterungen
formatierter Codeblock
1 2 3 |
|
ergibt:
1
|
|
Nach gegenwärtigem Kenntnisstand kann so ein Codeblock nicht Bestandteil einer Liste sein! (Octopress-2.0 und 2.1)
Datei
1 2 3 4 5 6 |
|
Bild
Tabelle
Titel1 | Titel 2 | Titel 3 | Titel 4 |
---|---|---|---|
normal | linksbündig | rechtsbündig | zentriert |
Zeile 2, Spalte 1 | Zeile 2, Spalte 2 | Zeile 2, Spalte 3 | Zeile 2, Spalte 4 |
Gitea: Inhaltsverzeichnis
Ein Inhaltsverzeichnis kann für Gitea im Markdowndokument aktiviert werden mit dem Header
1 2 3 4 |
|
Details s. http://daemons-point.com/blog/2022/08/05/gitea-toc/
Tests
Liste mit Codeblock
- Liste
- mit Codeblock
1 2 |
|
Codeblock lt. Octopress-Erweiterungen funktioniert
Wechsel der Aufzählungszeichen
- Punkt 1
- Punkt 2
- Unterpunkt 1
- Unterpunkt 2
- Unter-Unterpunkt
- noch ein Punkt
- noch ein Punkt
- Unter-Unterpunkt
- Unter-Unterpunkt
- Unterpunkt 3
- Punkt 3
- Punkt 3.1
- Punkt 3.2
Änderungen
2013-07-22
- Anzeige der Original-Eingaben
2022-08-10
- Inhaltsverzeichnis in Gitea