Flower

← Alle Module · Daten & Formate

markdown

Liest, durchsucht und bearbeitet Markdown-Dateien (.md): wandelt sie nach HTML oder reinem Text um, liest Überschriften, Tabellen, Links und einzelne Abschnitte aus und kann Inhalte, Abschnitte sowie YAML-Frontmatter gezielt setzen oder ergänzen. Der Block hält die Datei im Speicher; Änderungen werden erst mit "speichern" zurückgeschrieben.

Block-Einstellungen

Gelten für den ganzen Modul-Block (im Editor oben im Inspektor, in YAML direkt unter dem Modulnamen).

FeldTypPflichtBeschreibung
dateiText—Pfad zur .md-Datei. Wird beim Block-Eintritt geladen (fehlt sie, startet der Block mit leerem Inhalt). Optional — ohne 'datei' arbeiten 'nach-html'/'nach-text' auf dem 'text'-Input; lesen/speichern brauchen jedoch eine 'datei'.

Aktionen

lesenlesend

Gibt den rohen Markdown-Text der Datei zurück (erfordert 'datei').

Ausgaben (über ergebnis:)

textDer vollständige Markdown-Text der Datei.

nach-htmllesend

Rendert den Markdown-Text (oder den 'text'-Input) als HTML.

Eingaben

FeldTypPflichtBeschreibung
textText—Markdown-Text, der gerendert werden soll. Fehlt er, wird der geladene Datei-Inhalt verwendet.

Ausgaben (über ergebnis:)

htmlDas gerenderte HTML.

nach-textlesend

Entfernt alle Markdown-Formatierungszeichen und liefert reinen Fließtext.

Eingaben

FeldTypPflichtBeschreibung
textText—Markdown-Text, der entformatiert werden soll. Fehlt er, wird der geladene Datei-Inhalt verwendet.

Ausgaben (über ergebnis:)

textDer Klartext ohne Markdown-Syntax.

überschriftenlesend

Listet alle Überschriften der Datei mit ihrer Ebene auf.

Ausgaben (über ergebnis:)

überschriftenListe von Objekten je Überschrift mit 'ebene' (Zahl 1-6) und 'text'.

abschnitt-lesenlesend

Gibt den Text unterhalb einer bestimmten Überschrift bis zur nächsten gleich- oder höherrangigen Überschrift zurück.

Eingaben

FeldTypPflichtBeschreibung
überschriftTextjaTitel der gesuchten Überschrift (Groß-/Kleinschreibung egal).

Ausgaben (über ergebnis:)

textDer Inhalt des Abschnitts (ohne die Überschrift selbst).

abschnitt-setzenverändernd

Ersetzt den Inhalt unterhalb einer Überschrift durch neuen Text (im Speicher; mit 'speichern' zurückschreiben).

Eingaben

FeldTypPflichtBeschreibung
überschriftTextjaTitel des zu ersetzenden Abschnitts.
textText—Neuer Inhalt des Abschnitts. Fehlt er, wird der Abschnitt geleert.

tabellenlesend

Extrahiert alle Markdown-Tabellen als verschachtelte Zellen-Listen (inkl. Kopfzeile).

Ausgaben (über ergebnis:)

tabellenListe von Tabellen; jede Tabelle ist eine Liste von Zeilen, jede Zeile eine Liste von Zellen-Texten.

linkslesend

Listet alle Links im Dokument als Text/Ziel-Paare auf.

Ausgaben (über ergebnis:)

linksListe von Objekten mit 'text' (Linktext) und 'ziel' (URL).

inhaltsverzeichnislesend

Baut aus den Überschriften ein eingerücktes Inhaltsverzeichnis als Markdown-Liste.

Eingaben

FeldTypPflichtBeschreibung
max-ebeneZahl—Maximale Überschriften-Ebene, die aufgenommen wird (1-6; 0 bzw. fehlend = alle bis 6).

Ausgaben (über ergebnis:)

markdownDas Inhaltsverzeichnis als eingerückte Markdown-Aufzählung.

frontmatter-lesenlesend

Liest das YAML-Frontmatter (--- am Dateianfang) als Objekt aus.

Ausgaben (über ergebnis:)

inhaltDas Frontmatter als Objekt (flache Schlüssel/Wert-Paare). Fehlt Frontmatter, schlägt die Aktion fehl ('kein-frontmatter').

frontmatter-setzenverändernd

Schreibt/ersetzt das YAML-Frontmatter am Dateianfang (im Speicher; mit 'speichern' zurückschreiben).

Eingaben

FeldTypPflichtBeschreibung
inhaltObjekt—Das neue Frontmatter als Objekt. Fehlt es, wird ein leerer Frontmatter-Block geschrieben.

anhängenverändernd

Hängt Text an das Ende des Dokuments an (im Speicher; mit 'speichern' zurückschreiben).

Eingaben

FeldTypPflichtBeschreibung
textTextjaDer anzuhängende Markdown-Text.

schreibenverändernd

Ersetzt den gesamten Dokument-Inhalt durch neuen Text (im Speicher; mit 'speichern' zurückschreiben).

Eingaben

FeldTypPflichtBeschreibung
textText—Der neue Gesamt-Inhalt. Fehlt er, wird der Inhalt geleert.

speichernverändernd

Schreibt den aktuellen Inhalt zurück in die geladene Datei (erfordert 'datei').

speichern-unterverändernd

Schreibt den aktuellen Inhalt in eine angegebene Zieldatei.

Eingaben

FeldTypPflichtBeschreibung
pfadTextjaZielpfad für die zu schreibende .md-Datei.

Beispiele

Struktur eines Berichts auslesen

Liest aus einem Markdown-Bericht das Inhaltsverzeichnis und alle Links für eine Übersicht.

markdown
inhaltsverzeichnis
datei (Block)N:\\Berichte\\quartal.md
max-ebene2
ergebnistoc
markdown
links
ergebnisalle_links
- markdown:
    datei: "N:\\Berichte\\quartal.md"
    aktionen:
      - inhaltsverzeichnis:
          max-ebene: 2
          ergebnis: toc
      - links:
          ergebnis: alle_links

Abschnitt aktualisieren und speichern

Setzt das Frontmatter, ersetzt den Inhalt eines Abschnitts und schreibt die Datei zurück.

markdown
frontmatter-setzen
datei (Block)C:\\Notizen\\readme.md
inhalt{ titel: Projektstatus, autor: Anna }
markdown
abschnitt-setzen
überschriftStatus
textAlle Aufgaben erledigt.
- markdown:
    datei: "C:\\Notizen\\readme.md"
    aktionen:
      - frontmatter-setzen:
          inhalt:
            titel: Projektstatus
            autor: Anna
      - abschnitt-setzen:
          überschrift: Status
          text: "Alle Aufgaben erledigt."
      - speichern: {}