Package Information
Available Nodes
Documentation generating…
Documentation
ARI Miro Board Export
n8n-Erweiterung von Stefan Alt · ARI Studio zum Export von Miro-Boards als PDF oder als KI-Wissenspaket.
Exportmodi
Exportiert unterstützte Miro-Inhalte als PDF. Unicode-Text wird mit eingebetteten DejaVu-Schriften gerendert.
KI-Wissenspaket
Die Node erkennt Board-Bereiche mit Bezeichnungen wie Tag 1, Tag 2, Tag 3 usw. und erzeugt daraus getrennte Markdown-Wissensdateien. Sie extrahiert zusätzlich wiederkehrende Schlüsselbegriffe direkt aus dem Text. Das funktioniert ohne KI-Dienst und ist nicht auf Themen wie n8n oder Automatisierung festgelegt.
<boardname>-ki-assistent.zip
├── masterprompt.md
├── modul-wissen-tag-1.md
├── modul-wissen-tag-2.md
├── modul-wissen-tag-3.md
└── ...
Erweiterte Wissensexporte
Der bisherige Standard bleibt erhalten: Gesamtes Board, eine Markdown-Datei pro erkanntem Tag, Standard-Masterprompt, Übungen und Teilnehmerinhalte ausgeschlossen, strenge Prüfung lückenloser Tage und genau eine ZIP-Binärdatei als Ausgabe.
Für den Wissensexport stehen zusätzlich diese Optionen zur Verfügung:
- Exportumfang: gesamtes Board, einzelner Tag, einzelner Frame oder mehrere Frames per Frame-ID.
- Dateiaufteilung: pro Tag, pro Frame oder eine gemeinsame
wissen.md. - Übungen und Teilnehmerinhalte: ausschließen, in die Wissensdateien aufnehmen oder separat als
uebungen-tag-X.mdbeziehungsweiseworkshop-ergebnisse-tag-X.mdexportieren. - Analysemodus: liefert JSON mit Tags, Frames, Klassifizierungszahlen, nicht zugeordneten Items, fehlenden Tagen und leeren Frames. Er erzeugt kein ZIP.
- Quellenmetadaten: optional Tag, Frame-Titel, Frame-ID und Item-IDs bei jeder Sektion.
- Filterregeln: Titel und Text ein- oder ausschließen. Regeln werden zeilenweise eingegeben, optional als reguläre Ausdrücke.
- Zusatzdateien:
links.md,export-report.mdundmanifest.json. - Masterprompt: Standard, eigener Text mit
{{dateien}}oder komplett deaktiviert. - Dateinamen: optional etwa
tag-03-api-und-webhooks.mdstatt des bisherigen Namens.
Identische Texte werden innerhalb eines Exports nur einmal übernommen. Die Filterung bleibt regelbasiert. Es gibt keine semantische Bewertung und keine externen KI-Aufrufe.
Einstellungen der Node
| Einstellung | Beschreibung |
|---|---|
| Board-ID oder URL | Die Miro-Board-ID oder die vollständige Miro-Board-URL. Unsichtbare Leer- und Formatzeichen werden entfernt. |
| Exportmodus | PDF erzeugt den bisherigen PDF-Export. KI-Wissenspaket erzeugt Markdown-Dateien in genau einer ZIP-Binärdatei. |
| Darstellung und Seitengröße | Nur für PDF. Wähle eine Seite pro Frame oder das gesamte Board sowie A3 oder A4 im Querformat. |
| Übungs-/Workshop-Bereiche ausschließen | Bisherige Ausschlussoption für Übungen. Zusammen mit „Umgang mit Übungen“ bleibt sie für bestehende Workflows wirksam. |
| Teilnehmernotizen und Gespräche ausschließen | Bisherige Ausschlussoption für Teilnehmer-, Gesprächs- und persönliche Inhalte. |
| Ausführung | Nur analysieren liefert JSON ohne ZIP. Wissenspaket exportieren erzeugt das ZIP. |
| Exportumfang | Exportiert das gesamte Board, einen Tag oder Frames. Bei Frame-Auswahl werden die IDs aus dem Analyseergebnis verwendet. |
| Tag-Nummer | Die Nummer des Tags für den Exportumfang „Einzelner Tag“. |
| Frame-ID / Frame-IDs | Eine Frame-ID oder mehrere, per Komma oder Zeilenumbruch getrennt. Die IDs stehen im Analyseergebnis unter analysis.detectedFrames. |
| Dateiaufteilung | Eine Markdown-Datei pro Tag, pro Frame oder eine gemeinsame wissen.md. |
| Sprechende Dateinamen | Erzeugt bei Tag-Dateien Namen wie tag-03-api-und-webhooks.md. Ohne diese Option bleiben die bisherigen Dateinamen erhalten. |
| Umgang mit Übungen | Verwendet die bisherige Ausschlussoption, schließt Übungen aus, exportiert sie getrennt oder nimmt sie in die Wissensdateien auf. |
| Umgang mit Teilnehmer- und Workshop-Inhalten | Entspricht der Übungsoption für Teilnehmer-, Gruppen- und Workshop-Inhalte. Der separate Export heißt beispielsweise workshop-ergebnisse-tag-3.md. |
| Strenge Tagesprüfung | Bricht beim regulären Tagesexport ab, wenn Tag-Marker fehlen. Für einen bewusst taglosen Frame-Export kann sie ausgeschaltet werden. Der Analysemodus zeigt fehlende Tage immer als JSON an. |
| Quellenmetadaten einfügen | Fügt Tag, Frame-Titel, Frame-ID und Miro-Item-IDs an die exportierten Sektionen an. |
| Links sammeln | Schreibt alle im lesbaren Boardtext gefundenen URLs in links.md. |
| Assets übernehmen | Übernimmt direkt über die Miro-API erreichbare Bilder und Dokumente nach assets/. Nicht abrufbare Assets werden als Warnung gemeldet. |
| Bildtext lokal erkennen (OCR) | Erkennt Text in abrufbaren PNG-, JPEG- und BMP-Bildern lokal. Die Option erscheint erst, wenn „Assets übernehmen“ aktiv ist. |
| OCR-Sprache | Wählt die lokal mitgelieferten deutschen oder englischen Sprachdaten. |
| Maximale Anzahl OCR-Bilder | Begrenzt die Anzahl der Bilder pro Export. Standard sind 20 Bilder. |
| Maximale OCR-Bildgröße in MB | Überspringt große Bilder, um Speicherverbrauch und Laufzeit zu begrenzen. Standard sind 8 MB pro Bild. |
| Mindestqualität für OCR in Prozent | Übernimmt nur Text mit ausreichender Erkennungsqualität. Übersprungene Ergebnisse erscheinen als Warnung. |
| Exportbericht erzeugen | Schreibt export-report.md mit Boarddaten, gezählten Items, Dateien, Warnungen und nicht zugeordneten Inhalten. |
| Manifest erzeugen | Schreibt manifest.json mit Board-, Frame- und Item-Metadaten sowie Dateinamen. |
| Masterprompt | Erzeugt den Standard-Prompt, verwendet eigenen Text oder lässt masterprompt.md weg. Im eigenen Text ersetzt {{dateien}} die Dateiliste. |
| Frame-Titel enthält / enthält nicht | Zeilenweise Einschluss- und Ausschlussregeln für Frame-Titel. Ausschlussregeln haben Vorrang. |
| Text enthält / enthält nicht | Zeilenweise Einschluss- und Ausschlussregeln für Item-Texte. Wenn Einschlussregeln vorhanden sind, muss mindestens eine passen. |
| Reguläre Ausdrücke verwenden | Wertet die Filterregeln als reguläre Ausdrücke aus. Ungültige Ausdrücke brechen mit einer klaren Fehlermeldung ab. |
| Binärfeld | Name des n8n-Binärfelds für PDF oder ZIP. Standard ist data. |
Dateien und Bilder
Wenn Assets übernehmen aktiv ist, lädt die Node Bilder und Dokumente nur dann nach assets/, wenn Miro für das Item eine direkt abrufbare Download-URL liefert. Die Node verwendet dafür die vorhandenen Miro-Zugangsdaten. Nicht verfügbare Dateien stoppen den Export nicht, erscheinen aber als Warnung im Node-Ergebnis und, falls aktiviert, im Exportbericht.
Wenn zusätzlich Bildtext lokal erkennen (OCR) aktiv ist, verarbeitet die Node unterstützte Bilder mit lokal eingebetteten Tesseract-Sprachdaten. Bildinhalte, erkannte Texte und Sprachdaten verlassen dabei weder die Node noch den n8n-Server. Erkannte Texte werden unter „Erkannter Bildtext“ in die passende Wissensdatei geschrieben und enthalten Bild-ID, Frame-ID sowie die Erkennungsqualität. Nicht unterstützte Dateitypen, zu große Bilder und Ergebnisse unter der Mindestqualität werden nicht als Wissen übernommen.
Fachliche Miro-Textobjekte werden direkt übernommen. Es werden keine externen KI-Dienste aufgerufen und es entstehen durch den Wissensexport keine zusätzlichen API-Kosten außerhalb der ohnehin verwendeten Miro-Anbindung.
Übungen, Aufgaben, Ergebniswände, Teilnehmergespräche, persönliche Beiträge und organisatorische Kursbereiche können automatisch ausgeschlossen werden. Die Zuordnung nutzt übergeordnete Miro-Beziehungen, die geometrische Position im Board und erkannte Tag X-Marker.
Die Node prüft die Tag-Reihenfolge auf Vollständigkeit. Wenn z. B. Tag 1 bis Tag 7 erkannt werden sollen, aber Tag 6 fehlt, wird der reguläre Export abgebrochen, statt ein unvollständiges Wissenspaket zu erzeugen. Im Analysemodus wird der fehlende Tag gemeldet. Bei einem bewusst taglosen Frame-Export kann die strenge Tagesprüfung ausgeschaltet werden.
Nicht eindeutig einem Tag zuordenbare fachliche Texte werden nicht still verworfen, sondern bei Bedarf in nicht-zugeordnet.md gesichert.
Die Node gibt für den KI-Wissensexport genau eine ZIP-Datei als Binärausgabe zurück. Das ZIP wird mit fflate erzeugt und vor der Ausgabe intern wieder entpackt und geprüft.
Benötigte Zugangsdaten
Miro API
Erforderlich für alle Exporte. Der Zugriffstoken benötigt mindestens boards:read.
Weitere Zugangsdaten oder externe KI-APIs werden nicht benötigt.
Grenze des Wissensexports
Die Node übernimmt Inhalte, die Miro über die verwendete REST-API als auslesbare Textinformationen liefert. Reine Bildpixel werden nicht an externe Dienste gesendet und nicht automatisch interpretiert.
Installation
Installiere n8n-nodes-ari-miro-board-pdf unter Einstellungen → Community Nodes in n8n und hinterlege die Miro-Zugangsdaten.
Entwicklung
pnpm install
pnpm build
pnpm lint
Mehr zu ARI Studio: https://ari-studio.de