Installation von Marp CLI (ansteuerbar mit Word)

https://github.com/marp-team/marp-cli/releases/

Download der Zip-Datei der aktuellsten Windowsversion und Abspeichern der entpackten marp.exe unter C:\Program Files\marp-cli\marp.exe (Administratorenrechte zum Erstellen des Ordners und dem Verschieben erforderlich!!)

Download Menüband

Ablegen des Menübandes im STARTUP-Ordner von Word (erreichbar über %appdata%, Microsoft, Word).

Neuerungen in der V1.1 des Menübandes:

Erweiterung des Kopfes (Nutzung eigener Themedatei)
Härtung des gesamten Codes
Kopf ist nun auch im Nachhinein zu bearbeiten, der Block am Beginn des Dokuments wird dann entsprechend edititert
Barrierefreiheit der Dialogfelder wurde erhöht (Komboboxen werden nun bei Änderung angesagt)
Bei Leerzeichen in Bilder, Audio und Video Dateinamen wird automatisch das erforderliche Zeichen ersetzt (meine Bilder.jpg wird zu meine%20Bilder.jpg), sodass eine Wandlung möglich ist.
Exportieren mit Stil erstellt eine rudimentäre style.css (falls nicht schon eine eigene vorhanden), die eine etwas größere Schrift und bessere Darstellungsmöglichkeiten von Tabellen bietet, Titelfolienlayout unterstützt und sonst auf dem Standardtheme basiert.
Über das Stilmenü lassen sich individuelle Farbkombinationen für Hintergrund, Schrift, Überschrift 1 und Hervorhebungen in der Überschrift auswählen, zudem kann die Schriftart geändert werden
Bei "Übergänge" kann eine Transition für den Folienübergang gewählt werden.
Funktionen für Fortgeschrittene: Tabellenvorlage, Codeblockvorlage, Script um Mermaid Diagramme einbinden zu können.

Bedienung:

Aufruf des Menüs: ALT+#

Kopf: K

Bild: B

neue Folie: FL

Link: L

Audio: A

Video: V

Hilfe: H

Export: EX

Export mit Stil: ES

Titelfolie: TT

Titelfolie inverst: TI

Stil: ST

Übergänge: Ü

Tabellen: TB

Codeblock: C

Mermaid-Script: MM

Funktionalität

Gruppe Gestaltung

Kopf

Im Kopf lassen sich Startparameter festlegen. Diese werden in den Steuerungskopf der Datei geschrieben. Der Block wird bei erstmaliger Nutzung angelegt.

---

marp: true

---

Dunkler Hintergrund aktiviert das Inverse Schema (class: invert)
Seitenzahlen aktiviert die Foliennummerierung (paginate: true)
Titel der Präsentation erscheint als Name im Tab des Browsers bzw. in der Fensterleiste der PDF
Fußzeile und Kopfzeile
eigene Stildatei ermöglicht Anpassungen an Folienübergängen, Schriftart, Farben.

Bild

Über dieses Dialogfenster lassen sich Bilder einfügen. Der Dateiname muss zwingend mit Dateiendung eingegeben werden (.jpg oder .png). Die Position kann über das Kombinationsfeld ausgewählt werden (rechts, links, Vollbild), die Kurzbeschreibung erscheint in der html Datei am Ende als Alternativtext. Leerzeichen werden seit dieser Version durch die passenden Steuerungszeichen ersetzt, sind also kein Problem mehr.

Über die Checkbox "Bild an die Folie anpassen" kann zusätzlich der Parameter "fit" eingefügt werden.

neue Folie

Dies fügt eine Leerzeile, den Folientrenner --- und eine neue Zeile ein.

Link

Der Baustein [Linktext](https:\\linkadresse) wird eingefügt. Der Linktext in den eckigen Klammern erscheint sichtbar in der Präsentation, die linkadresse muss vollständig eingefügt werden.

Audio und Video

Hier muss wie beim Bild der gesamte Dateiname eingegeben werden. Leerzeichen werden seit dieser Version durch die passenden Steuerungszeichen ersetzt, sind also kein Problem mehr.

Hilfe

Hier finden sich die wichtigsten Auszeichnungsmöglichkeiten.

Exportoptionen

Es gibt zwei Optionen für den Export. Möchte man einfach das Standardtheme, welches der Entwickler von Marp entworfen hat, Gaia oder Uncover, so genügt es einfach zu Exportieren. Es werden immer eine PDF und eine HTML Datei erzeugt. Zusätzlich wird das "Zwischenprodukt" Markdown mit der Endung .md geschrieben.

Exportieren mit Stil bietet in der Grundeinstellung das Standardtheme mit etwas größerer Schrift und besserer Folienausnutzung bei Tabellen. Um zentrierte Titelfolien erstellen zu können, ist hier eine zusätzliche Klasse eingefügt, welches den Titel, etwas größer und zentriert auf der so ausgezeichneten Folie platziert. Außerdem lassen sich individuelle Farb- und Schriftartanpassungen über den Stildialog einbinden.

Im Hintergrund wird eine .css Datei geschrieben, die im Präsentationsordner liegt und für den Export dann genutzt wird.

Titelfolie und Titelfolie invers

Um solche Titelfolien zu erzeugen muss auf der gewünschten Folie  oder  geschrieben werden. Dies übernehmen die beiden Buttons. Wichtig: Die Ausrichtung funktioniert nur bei Export mit Stil!

Stil

In diesem Dialogfenster lassen sich Farben anpassen (Farben aus Ausklappliste auswählen oder als HEX-Code eingeben)

Hintergrundfarbe, Schriftfarbe, Überschrift 1 und Hervorhebungen in Überschriften lassen sich so festlegen. Sind die Standardwerte gesetzt, so kann man weiterhin über class: invert die Invertierung aktivieren. Man kann natürlich auch über das Menü ein eigenes dunkles Schema entwickeln. Wichtig ist aber in diesem Falle, die Farbkombination vorab visuell prüfen zu lassen.

Neben der Farbanpassung kann auch die Schriftart für den Text aus einer Ausklappliste gewählt werden.

Diese Anpassungen greifen nur, wenn Exportieren mit Stil gewählt wird.

Übergänge

Marp bietet einige vorgefertigten Folienübergänge, diese lassen sich über dieses Dialogfenster auswählen. Empfohlen wird von mir fade, da dies dezent und aufwertend erscheint. Die Übergänge haben nur Auswirkungen auf die html Datei, nicht die PDF.

Tabelle

Über einen Abfrage Dialog (Wieviele Zeilen, wie viele Spalten, Header ja/nein) kann die Grundstruktur einer Markdown Tabelle eingefügt werden.

Die Leerzeichen zwischen den | müssen dann durch den gewünschten Text ersetzt werden. Eine Tabellenvorlage mit 3 Spalten und 2 Zeilen und Header sieht dann so aus:

| | | |

| --- | --- | --- |

| | | |

gefüllt:

|Kopf1|Kopf2|Kopf3|

| --- | --- | --- |

|Zeile1|Zeile1|Zeile1|

Codeblock

Hier wird exemplarisch ein Python Codeblock eingefügt (Sprache einfach anpassen für korrektes Highlighting). In die Zeile unter den Sprachnamen vor den nächsten ``` dann den gewünschten Code schreiben.

```python

```

Mermaid Script

Um Mermaid Diagramme einbinden zu können, muss ein Script zusätzlich eingebaut werden. Dies muss irgendwo in der Präsentation stehen, nur nicht im Kopf. Dieser Block wird über das Menü eingefügt:

<script type="module">
import mermaid from  'https://cdn.jsdelivr.net/npm/mermaid@latest/dist/mermaid.esm.min.mjs';
mermaid.initialize({ startOnLoad: true });
</script>

Dann kann über ein div auf einer Folie ein Diagramm erzeugt werden. Beispiel:

<div class="mermaid">
  graph LR;
  a --> b;
  b --> c;
  c --> a;
 </div>