User Tools

Site Tools


offer-cube:faq:faq_use_markdown

offer-cube FAQ / Markdown verwenden

Allgemeines / Zusammenfassung

Markdown ist eine vereinfachte Auszeichnungssprache, bei der mit einfachen Steuer-Zeichen wie z.B. Zeilenbeginn mit # (Raute) eine Überschrift eingeleitet wird.

Der Vorteil in Markdown liegt darin, dass direkt beim Tippen auf der Tastatur die Formatierung wie z.B. Überschrift oder Fett getippt werden kann ohne wie im WYSIWYG Richtext Editor mit der Maus z.B. Fett auswählen zu müssen.
Da es sich um reinen Text handelt, kann die Formatierung auch nicht durcheinander geraten und bleibt auch in reiner Textform für den Menschen gut lesbar.

Näher Informationen zu Markdown findet sich im Wikipedia Artikel zu Markdown.

Ein Beispiel für Markdown:

# Überschrift 1
Hier steht ein Text.
Der Text in der nächsten Zeile wird dann später direkt an den Text der ersten Zeile angehängt.

Möchte man einen Absatz machen, muss eine Leerzeile eingefügt werden.

## Überschrift 2 mit Aufzählungspunkten

Folgende Punkte sind hervorzuheben:
- Punkt 1: Nur mit der Tastatur schreiben.
- Punkt 2: Auch im Rohtextformat für den Menschen gut lesbar.
- Punkt 3: Das gerenderte Ergebnis wird dann im PDF dargestellt.
- Punkt 4: Es lässt sich im Notfall HTML "dazumischen".

Hier ein **fettes** Beispiel mit <font color="#ff0000">rotem Text</font>.

Und hier das dazugehörige Ergebnis im PDF:

Beispiel als Markdown formatiert und PDF Ergebnis

Einstellungen: Markdown aktivieren

Unter Einstellungen –> Systemeinstellungen –> Sonstige Einstellungen –> “Markdown-Rendering (beta) verwenden? = Ja” kann der Markdown Renderer aktiviert werden.

ACHTUNG: ALLE BISHERIGEN TEXTE WERDEN AB SOFORT ALS MARKDOWN INTERPRETIERT!

Nun im WYSIWYG Editor formatieren

HTML WYSIWYG Richtext-Editor temporär deaktivieren

Ist zusätzlich auch der HTML WYSIWYG Richtext-Editor aktiviert, kann über einen Link unterhalb der Textfelder bequem auf reine Textansicht gewechselt werden.
Hierbei bleiben eventuelle HTML Formatierungen erhalten - diese müssen per Hand korrigiert werden.

HINWEIS: OfferCube merkt sich, dass der HTML Editor deaktiviert wurde. Das heißt auch nach erneutem Login bleibt der Editor deaktiviert. Er kann über denselben Link unterhalb der Textfelder wieder aktiviert werden.

HTML WYSIWYG Richtext-Editor temporär deaktivieren

offer-cube/faq/faq_use_markdown.txt · Last modified: 2023/06/08 10:56 (external edit)