Textformatierung für Menschen.
ZIP-Datei herunterladen und in dein system/extensions-Verzeichnis kopieren. Weitere Informationen zu Erweiterungen.
Markdown ist eine praktische Art um Webseiten zu bearbeiten. Schreibe Text wie in einer E-Mail und daraus wird eine Webseite. Nach einer kurzen Zeit passiert das ganz natürlich, ohne dass man darüber nachdenkt. Das vorrangige Designziel der Markdown-Syntax besteht darin, sie so lesbar wie möglich zu machen. Hier sind die Markdown-Syntax, Markdown-Extra-Funktionen und GitHub-Flavored-Markdown.
Der Standard-Inhaltsparser wird in der Datei system/extensions/yellow-system.ini festgelegt. Ein anderer Inhaltsparser lässt sich in den Seiteneinstellungen ganz oben auf jeder Seite festlegen, zum Beispiel Parser: markdown.
Markdown ist eine flexible Art um Webseiten zu bearbeiten. Markdown-formatierter Text kann mit jedem Texteditor geöffnet werden. Oder es kann im Webbrowser bearbeitet werden. Die meisten Anwendungen unterstützen die grundlegende Markdown-Syntax, einige Anwendungen bieten Abkürzungen mit zusätzlichen Funktionen für Webseiten. Das gibt dir beispielsweise die Möglichkeit Bilder und Bildergalerien einzubinden. Die verfügbaren Abkürzungen hängen von den installierten Erweiterungen ab.
Inhaltsdatei mit Seitentitel und Text:
---
Title: Beispielseite
---
Das ist eine Beispielseite.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod
tempor incididunt ut labore et dolore magna pizza. Ut enim ad minim veniam,
quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo.
Text formatieren:
Normal **Fettschrift** *Kursiv* ~~Durchgestrichen~~ `Code`
Eine Liste erstellen:
* Punkt eins
* Punkt zwei
* Punkt drei
Eine sortierte Liste erstellen:
1. Punkt eins
2. Punkt zwei
3. Punkt drei
Eine Aufgabenliste erstellen:
- [x] Punkt eins
- [ ] Punkt zwei
- [ ] Punkt drei
Eine Überschrift erstellen:
# Überschrift 1
## Überschrift 2
### Überschrift 3
Zitate erstellen:
> Zitat
>> Zitat im Zitat
>>> Zitat im Zitat im Zitat
Links erstellen:
[Link zu Seite](/help/how-to-make-a-small-website)
[Link zu Datei](/media/downloads/yellow-deutsch.pdf)
[Link zu Webseite](https://datenstrom.se/de/)
Bilder hinzufügen:
[image photo.jpg Beispiel]
[image photo.jpg "Dies ist ein Beispielbild"]
[image photo.jpg "Dies ist eine besonders lange Beschreibung"]
Tabellen erstellen:
| Kaffee | Milch | Stärke |
|------------|-------|---------|
| Espresso | nein | stark |
| Macchiato | ja | mittel |
| Cappuccino | ja | schwach |
Fußnoten erstellen:
Text mit einer Fußnote[^1] und noch weiteren Fußnoten.[^2] [^3]
[^1]: Hier ist die erste Fußnote
[^2]: Hier ist die zweite Fußnote
[^3]: Hier ist die dritte Fußnote
Quellcode anzeigen:
```
Quellcode wird unverändert angezeigt.
function onLoad($yellow) {
$this->yellow = $yellow;
}
```
Absätze erstellen:
Hier ist der erste Absatz. Der Text kann über mehrere Zeilen gehen
und kann durch eine Leerzeile vom nächsten Absatz getrennt werden.
Hier ist der zweite Absatz.
Zeilenumbrüche erstellen:
Hier ist die erste Zeile⋅⋅
Hier ist die zweite Zeile⋅⋅
Hier ist die dritte Zeile⋅⋅
Leerzeichen am Zeilenende sind dargestellt durch Punkte (⋅)
Hinweise erstellen:
! Hier ist ein Hinweis mit Warnung
!! Hier ist ein Hinweis mit Fehler
!!! Hier ist ein Hinweis mit Tipp
CSS benutzen:
! {.class}
! Hier ist ein Hinweis mit benutzerdefinierter Klasse.
! Der Text kann über mehrere Zeilen gehen
! und Markdown-Textformatierung beinhalten.
HTML benutzen:
<strong>Text mit HTML</strong> kann wahlweise benutzt werden.
<img src="/media/images/photo.jpg" alt="Dies ist ein Beispielbild">
<a href="https://datenstrom.se/de/" target="_blank">Link in einem neuen Tab öffnen</a>.
Abkürzungen mit zusätzlichen Funktionen benutzen:
[image photo.jpg] = Bild oder Miniaturbild hinzufügen
[gallery photo.*jpg] = Bildergalerie mit Popup hinzufügen
[slider photo.*jpg] = Bildergalerie mit Schieber hinzufügen
Erweiterung für eigene Abkürzung:
<?php
class YellowExample {
const VERSION = "0.1.2";
public $yellow; // access to API
// Handle initialisation
public function onLoad($yellow) {
$this->yellow = $yellow;
}
// Handle page content element
public function onParseContentElement($page, $name, $text, $attributes, $type) {
$output = null;
if ($name=="example" && ($type=="block" || $type=="inline")) {
$output = "<div class=\"".htmlspecialchars($name)."\">";
$output .= "Add more HTML code here";
$output .= "</div>";
}
return $output;
}
}
Diese Erweiterung enthält Markdown Extra 1.9.0 von Michel Fortin. Danke für die gute Arbeit.
Anna Svensson. Hilfe finden.