DokumentationÜbersicht öffnen
BloomMDEN

Dokumentation

Web-App

Lokale Ordner im Browser, ohne Upload.

Unter /app. Zwei Betriebsarten, die sich deutlich unterscheiden. Wenn Ordnerrechte, Sync oder Einladung haken, hilft die Fehlerbehebung.

Lokaler Ordner und Cloud im Überblick

  • Lokaler Ordner im Browser: Die Dateien liegen in deinem Ordner auf dem Rechner. Es wird nichts hochgeladen und es gibt keine Zusammenarbeit. Die Web-App unter /app verlangt die Anmeldung; nur die Browser-Demo kommt ohne Konto aus.
  • Cloud-Workspace: Die Dateien liegen in der Datenbank des Servers. Du brauchst ein Konto, Dateien werden importiert, und Zusammenarbeit läuft über den Sync-Server.

Die Gegenüberstellung ausführlich: Lokal oder Cloud.

Echter Screenshot der Web-App: Die Datei Kapitel 1 aus einem lokalen Ordner als Karte mit drei Unterknoten

Lokaler Ordner im Browser

Über die File System Access API öffnest du einen echten Ordner. Die Dateien bleiben auf deinem Rechner — es wird nichts hochgeladen, auch keine Anhänge oder PDFs. Eine Vorschau baut die Datei aus dem lokalen Handle zusammen, nicht über einen Server.

Der Berechtigungszustand ist sichtbar: Ist der Ordner nur zum Lesen freigegeben, erscheint ein Hinweis Nur Lesen mit einer Schaltfläche, um Schreibzugriff anzufragen. Das passiert bewusst erst auf Klick — Browser lehnen eine Berechtigungsanfrage ohne Nutzergeste ab.

Verfügbar in Chrome und Edge. Firefox und Safari unterstützen die API nicht.

Echter Screenshot der Web-App: Ein lokaler Ordner ist geöffnet, neben dem Ordnernamen steht der Hinweis Nur Lesen

Ordner öffnen, Schritt für Schritt

  1. In /app oben das Ordner-Symbol (Tooltip Open local Markdown folder) wählen.
  2. Den Ordner im Browser-Dialog freigeben.
  3. Steht neben dem Ordnernamen Nur Lesen, ist der Ordner nur zum Lesen freigegeben. Ein Klick auf den Hinweis fragt den Schreibzugriff an; der Browser fragt dich dann.
  4. In der Auswahlliste neben dem Ordnernamen eine Datei öffnen.

Neue Datei aus einer Vorlage

Mit Schreibzugriff legst du über + Datei eine neue Mindmap im Ordner an. Im Dialog wählst du Ordner, Vorlage und Name. Eingebaut sind Vorlesung, Cornell, Literaturnotiz, Prüfungsvorbereitung und Projekt; Leer legt nur die Überschrift an. Eigene Vorlagen liegen als Markdown im Ordner Vorlagen deines Workspaces.

Echter Screenshot der Web-App: Der Dialog für eine neue Datei mit Ordner, Vorlage Vorlesung und Name

Browser-Demo

Die Browser-Demo braucht kein Konto. Sie lädt eine eingebaute Vorlage; dein Markdown bleibt im Browser, solange du es nicht herunterlädst. Eigenes Markdown fügst du links ein oder wählst eine lokale Datei.

Echter Screenshot der Browser-Demo: Links ein Markdown-Eingabefeld, rechts die Karte der Vorlage Software Architecture Map

Cloud-Workspace

Mit Konto. Dokumente liegen in der Datenbank, Zusammenarbeit läuft über den Sync-Server. Die Registrierung (offen, ohne Einladung) ist unter Kostenloser Testaccount beschrieben.

Ist ein Sync-Server verbunden, steht im Kopf neben dem Dateititel der Sync-Status, zum Beispiel Synchronisiert. Er erscheint nur bei breiten Fenstern (ab 1536 Pixel).

Echter Screenshot der Kopfzeile der Web-App: Neben dem Dateititel Graphentheorie steht der Sync-Status Synchronisiert

Markdown-Datei in den Cloud-Workspace laden

  1. Melde dich auf https://bloommd.app mit deinem Testaccount an.
  2. Öffne die App und wähle den Cloud-Workspace, in dem die Datei landen soll.
  3. Nutze in der Toolbar oder Command-Palette Markdown importieren.
  4. Wähle eine .md- oder .markdown-Datei aus.
  5. Öffne die importierte Datei aus der Dateiliste und prüfe die Karte.

Ab diesem Moment liegt die Markdown-Datei serverseitig im Cloud-Workspace und kann mit Sync und Zusammenarbeit genutzt werden. Das ist bewusst anders als Lokaler Ordner im Browser: Dort bleibt alles auf deinem Rechner und es wird nichts hochgeladen.

Bitte lade im Testaccount keine Zugangsdaten, Secrets, personenbezogenen Daten Dritter oder produktionskritischen Inhalte hoch. Für Fehlermeldungen reicht fast immer ein reduziertes Markdown-Beispiel.

Wenn zwei Personen dieselbe Datei speichern, gewinnt nicht einfach die letzte: Du bekommst einen Vergleich beider Fassungen und drei Möglichkeiten — die gespeicherte Fassung laden, deine behalten oder als Kopie sichern.

Feedback geben

Vorher einen Blick in die Fehlerbehebung: Dort stehen die häufigen Fälle.

Eingeloggte Nutzerinnen und Nutzer des Testaccounts nutzen den Feedback-Button in der App. Ein Screenshot ist Pflicht, ein kurzes Video ist optional. Bitte keine privaten Markdown-Inhalte, Zugangsdaten oder personenbezogene Daten Dritter hochladen. Wenn Login oder App nicht erreichbar sind, schreibe an feedback@bloommd.io. GitHub ist nur unser internes Triage-Ziel.

Zwei Kartenansichten

  • Dokument — die Gliederung der geöffneten Datei.
  • Workspace — Ordner, Dateien und ihre Verweise. Mit Layern für Struktur, Verweise und Backlinks, damit die Karte nicht unlesbar wird.