JSON-Format für Maps

Maps lassen sich als JSON-Datei exportieren und importieren. Diese Seite beschreibt das Format. Die Export-Datei einer bestehenden Map ist eine zuverlässige Vorlage für den Aufbau der JSON-Datei. Nicht jedes exportierte Feld und nicht jede Einstellung wird aber beim Import übernommen, die Tabellen unten beschreiben, was unterstützt wird.

Wer das KI-Modul in Edumaps nutzt, braucht dieses Format nicht: Öffnen Sie in der Map das Menü „Map-Optionen“ und wählen Sie „Inhalte ändern“. Dort beschreiben Sie in eigenen Worten, was die KI anlegen oder ändern soll.

Stand: 31.10.2026, Formatversion 2

1. Aufbau
2. Kleinste sinnvolle Datei
3. Beispiel
4. Datentypen
5. mapdata
6. Spalten
7. Boxen
8. Pfeile
9. Textfelder
10. Textformat
11. Dateien
12. Was nicht übertragen wird
13. Grenzen
14. KI-Assistent
15. Weiterführend

Aufbau der Datei

Eine Datei enthält genau ein JSON-Objekt mit diesen Schlüsseln. Der Import liest jeden Schlüssel über seinen Namen, die Reihenfolge spielt keine Rolle. Unbekannte Schlüssel werden ohne Meldung ignoriert.

Kleinste sinnvolle Datei

Pflicht ist nur der Titel der Map. Alles andere erhält beim Import den Standardwert: eine leere Pinnwand mit dem Standardhintergrund, ohne Spalten und Boxen. Die beiden Kopf-Schlüssel formatversion und format sind optional, der einzige Pflichtinhalt ist mapdata mit einem Titel. Eine Datei sollte den Kopf aber trotzdem enthalten.

{
	"formatversion": 2,
	"format": "Edumaps map export. Box content uses the Edumaps text markup (Markdown-like, raw HTML is shown literally). Documentation: https://www.edumaps.de/docs/json",
	"mapdata": {
		"title": "Meine Map"
	}
}

Beispiel-Map

Eine Map mit einer Spalte und zwei Boxen. Diese Datei lässt sich ohne Fehler importieren.

{
	"formatversion": 2,
	"format": "Edumaps map export. Box content uses the Edumaps text markup (Markdown-like, raw HTML is shown literally). Documentation: https://www.edumaps.de/docs/json",
	"mapdata": {
		"title": "Wasserkreislauf",
		"subtitle": null,
		"tags": "Erdkunde Klasse5",
		"mapbg": "i10",
		"mapfont": "0",
		"mapformat": "0",
		"maptype": "0",
		"flags": "0",
		"language": "de",
		"extras": null
	},
	"paths": [
		{
			"title": "Grundlagen",
			"visiblefrom": null,
			"visibleuntil": null,
			"annotation": null,
			"color": null,
			"flags": "0",
			"widthmode": "1",
			"extras": null,
			"boxes": [
				{
					"title": "Was ist der Wasserkreislauf?",
					"content": "Wasser ist ständig in Bewegung.\n\n- Verdunstung\n- Kondensation\n- Niederschlag",
					"subject": null,
					"booktime": null,
					"booklimit": "0",
					"color": null,
					"flags": "0",
					"ratingmode": "1",
					"position": null,
					"visiblefrom": null,
					"visibleuntil": null,
					"extras": null
				},
				{
					"title": "Weiterlesen",
					"content": "**Tipp:** Eine Übersicht bietet {der Artikel auf Wikipedia}{https://de.wikipedia.org/wiki/Wasserkreislauf}.",
					"subject": null,
					"booktime": null,
					"booklimit": "0",
					"color": "#3a86ff",
					"flags": "16",
					"ratingmode": "0",
					"position": null,
					"visiblefrom": null,
					"visibleuntil": null,
					"extras": null
				}
			]
		}
	]
}

Datentypen

• Die Datei ist UTF-8-kodiert und hat die Endung .json.
• Der Export schreibt jeden skalaren Wert als String oder als null (Objekte und Listen behalten ihren JSON-Typ), auch Zahlen und Flags (zum Beispiel "0"). Einzige Ausnahme ist formatversion, eine JSON-Zahl. Der Import akzeptiert Zahlen als String und als JSON-Zahl, "16" und 16 wirken gleich.
• Ein fehlendes Feld, null und ein leerer String bedeuten dasselbe: Der Import setzt den Standardwert aus den Tabellen unten.
• Der String "0" ist ein gültiger Text, auch als Map-Titel, Box-Titel und Box-Inhalt. Leer sind nur null und "".
• Steht in einem Feld für Text eine Liste oder ein Objekt, wird das Feld übersprungen und in der Meldung nach dem Import gezählt. Bei Titel und Anmerkung einer Spalte werden die Einträge einer Liste mit Leerzeichen verbunden.
• Flags sind Summen von Einzelwerten. Eine Box mit Farbfüllung (16) und ausgeblendetem Titel (64) hat "80".
• Farben in den Feldern color sind Hex-Strings mit Raute: "#RGB", "#RRGGBB" oder "#RRGGBBAA". Andere Werte werden verworfen, Pfeile erhalten dann "#0000ff", Textfelder "#ffff9c". Farben werden in Kleinbuchstaben gespeichert, Eingaben in Großbuchstaben werden angenommen. Farbiger Text im Box-Inhalt kennt nur 3 oder 6 Stellen (siehe unten).
• Zu lange Texte werden beim Import auf die angegebene Länge gekürzt, die Meldung nach dem Import nennt ihre Anzahl.

Felder von mapdata

Eine importierte Map ist immer unveröffentlicht und nicht gesperrt. Ein Map-Passwort ist nicht Teil des Formats.

Felder einer Spalte (paths)

Die Werte 8 und 16 entsprechen zusammen mit visiblefrom und visibleuntil der Option „Sichtbarkeit in der Mapansicht“ im Spalten-Editor: Wer die Map nur ansieht, sieht eine versteckte Spalte nie, Bearbeiter sehen sie im Bearbeitungsmodus weiterhin. Der Wert 512 („Im Bearbeitungsmodus vor Schülern verstecken“) blendet die Spalte zusätzlich im Bearbeitungsmodus aus, aber nur für Schüler.

Dateien der Formatversion 1 können noch die alten Werte 64 (breit) und 128 (doppelt breit) für die Spaltenbreite enthalten, sie werden weiter importiert. Ältere Dateien (Version 1) haben statt visiblefrom und visibleuntil ein Feld showdate und werden weiter importiert: ohne den Wert 256 in flags wird es als visiblefrom übernommen, mit 256 als visibleuntil.

Beispiel: Die Spalte erscheint am 01.11.2026 um 0 Uhr. Vorher sehen Betrachter nur ihren Titel mit dem Hinweis „Erscheint am …“, die Boxen noch nicht.

"flags": "16",
"visiblefrom": "2026-11-01"

Felder einer Box (boxes)

Die Werte 8192, 16384 und 32768 entsprechen zusammen mit visiblefrom und visibleuntil der Option „Sichtbarkeit in der Mapansicht“ im Box-Editor: Wer die Map nur ansieht, sieht eine versteckte Box oder ihren versteckten Inhalt nie, Bearbeiter sehen beides im Bearbeitungsmodus weiterhin. Der Wert 2097152 („Im Bearbeitungsmodus vor Schülern verstecken“) blendet die Box zusätzlich im Bearbeitungsmodus aus, aber nur für Schüler.

Dateien der Formatversion 1 können noch die alten Werte 2, 256 und 512 für die Bewertung enthalten, sie werden weiter importiert. Ältere Dateien (Version 1) haben statt visiblefrom und visibleuntil ein Feld showdate und werden weiter importiert: ohne den Wert 1048576 in flags wird es als visiblefrom übernommen, mit 1048576 als visibleuntil.

Weitere Werte gehören zu Kalender und Buchung (4096, 131072, 524288). Übernehmen Sie diese nur aus einer Export-Datei. Alle anderen Werte, zum Beispiel für Verkauf, Kursfortschritt und die vollständige Sperre, werden beim Import entfernt.

Der Wert 32768 wirkt nur vor dem Zeitpunkt in visiblefrom. Nach visibleuntil ist eine Box immer ganz ausgeblendet.

Beispiel: Die Box ist bis Freitag, 18.12.2026, 7 Uhr sichtbar, mit dem Hinweis „Sichtbar bis …“. Danach verschwindet sie für Betrachter ganz. Ein Datum ohne Uhrzeit bedeutet 0 Uhr dieses Tages: Mit "2026-12-31" ist die Box am 31.12. schon nicht mehr sichtbar, soll sie den 31.12. über sichtbar bleiben, schreiben Sie "2027-01-01".

"flags": "0",
"visibleuntil": "2026-12-18 07:00:00"

Pfeile (arrows)

Pfeile lassen sich nur im Map-Format Stickerwand (mapformat 2) hinzufügen. Ihre Position bezieht sich auf die gesamte Map, nicht auf eine Box oder Spalte. Auf der Pinnwand verschieben sich Boxen und Spalten dynamisch, ein Pfeil bliebe an seiner alten Stelle und zeigte auf falsche Inhalte. Stehen arrows oder labels in einer Datei mit einem anderen mapformat, werden sie trotzdem importiert und an ihrer Position angezeigt, lassen sich dort aber nicht neu hinzufügen und können verrutschen. Mehr dazu in den häufigen Fragen.

Textfelder (labels)

Textfelder lassen sich wie Pfeile nur im Map-Format Stickerwand (mapformat 2) hinzufügen, ihre Position bezieht sich auf die gesamte Map.

Box-Inhalt: das Edumaps-Textformat (Markdown-ähnlich)

Der Inhalt einer Box ist reiner Text im Edumaps-Textformat (Markdown-ähnlich), einem eigenen Format mit eigenen Regeln. Eine Leerzeile trennt Absätze, aufeinanderfolgende Zeilen werden mit einem Zeilenumbruch verbunden.

HTML wird nicht ausgeführt. Tags wie <p>, <ul> oder <a href=...> erscheinen in der Box als sichtbarer Text. Erhalten bleiben nur die Edumaps-Tags aus der Tabelle, als Block wie <check> und im Text wie <small>, genau so geschrieben (Kleinbuchstaben) und ohne Attribute.

Die Blöcke <check>, <check-yesno>, <poll>, <quiz> und <test…> beginnen mit dem öffnenden Tag in einer eigenen Zeile und enden mit dem schließenden Tag in einer eigenen Zeile. Vor dem öffnenden Tag und nach dem schließenden Tag steht jeweils eine Leerzeile, dazwischen keine. Nicht unterstützt sind Tabellen in der Form | A | B |, Überschriften mit ####, eingebettete Videos von anderen Websites (iframe, ein YouTube-Link wird zum Vorschaubild) und eigenes HTML. Videodateien, die auf Edumaps hochgeladen sind, erscheinen dagegen als Vorschaubild in der Box und spielen nach einem Klick in einem Overlay.

Dateien

Jeder Link auf eine Edumaps-Datei in der JSON-Datei wird beim Import in das importierende Konto kopiert, unabhängig davon, ob die Datei vom gleichen Server oder von einem anderen Edumaps-Server stammt und wem sie gehört. Der Link zeigt danach auf die Kopie, die Kopie belegt Speicherplatz dieses Kontos. Eine Option, die ursprünglichen Links beim Import zu behalten, gibt es nicht. Alle anderen Links bleiben Links. Schlägt eine Kopie fehl, bleibt der ursprüngliche Link stehen.

Was nicht übertragen wird

• Passwörter der Map, der Spalten und der Boxen sowie alle Zugangscodes. Die importierte Map erhält neue Codes.
• Veröffentlichung, Sperre und Löschschutz der Map. Die importierte Map ist unveröffentlicht und gehört dem importierenden Konto.
• Kommentare, Bewertungen und Likes, Kalendereinträge und Buchungen, Freigaben und Ordner, der Verlauf der Änderungen.
• Das Feld extras der Boxen.
• Ein Export über einen Leselink enthält keine ausgeblendeten Spalten und Boxen, keine Inhalte geschützter Boxen und keine Notizen mit //. Eingebettete Boxen und Spalten erscheinen im Export als Kopie.

Grenzen beim Import

• Maximale Größe der JSON-Importdatei: 2 MB.
• Höchstens 10 JSON-Importe und 5 neue Maps pro Minute, und nur im Rahmen des Map-Limits Ihres Tarifs.
• Der Speicherplatz des Kontos darf nicht voll sein.
• Mehr als 100 Spalten: Der Import wird abgelehnt.
• Höchstens 500 Boxen, 300 Pfeile und 300 Textfelder, wie im Editor. Was darüber liegt, wird weggelassen, die Meldung nach dem Import nennt die Anzahl.
• Textlängen: siehe die Tabellen oben.

Maps mit einem KI-Assistenten erzeugen

1. Legen Sie in Edumaps eine kleine Beispiel-Map an, mit den Spalten und Boxen, wie Sie sie sich vorstellen.
2. Exportieren Sie diese Map als JSON-Datei.
3. Geben Sie die Datei dem Assistenten (zum Beispiel Claude oder ChatGPT) als Vorlage mit, zusammen mit dieser Anweisung:

Erstellen Sie eine Edumaps-Map als gültige JSON-Datei. Nutzen Sie die angehängte Export-Datei als Vorlage für Struktur und Einstellungen und beachten Sie die Felder und Regeln unter https://www.edumaps.de/docs/json. Felder, die dort nicht dokumentiert sind, lassen Sie weg.
Regeln:
- Die Datei beginnt mit "formatversion": 2 und "format", danach folgen "mapdata" und "paths". Verwenden Sie nur die dokumentierten Schlüssel, "arrows" und "labels" nur, wenn Pfeile oder Textfelder gewünscht sind, und nur bei "mapformat": "2" (Stickerwand).
- Jede Spalte steht in "paths", jede Box in "boxes" ihrer Spalte.
- Zahlen und Flags als String schreiben, zum Beispiel "flags": "0". Nur "formatversion" ist die Zahl 2 ohne Anführungszeichen.
- Bewertung einer Box mit "ratingmode": "0" aus, "1" gut / mittel / schlecht, "2" ja / vielleicht / nein, "3" Option A / B / C. Breite einer Spalte mit "widthmode": "0" normal, "1" breit, "2" doppelt breit.
- Schreiben Sie alle Felder der Vorlage aus, leere als null (fehlende Felder akzeptiert der Import ebenfalls).
- Box-Inhalt im Edumaps-Textformat (Markdown-ähnlich): **fett**, Aufzählung mit "- ", Leerzeile zwischen Absätzen, Überschriften mit "# ", "## " oder "### ".
- Kein HTML: HTML-Tags erscheinen in Edumaps als sichtbarer Text.
- Nummerierte Listen mit "-- " am Zeilenanfang. Eine Zeile, die mit "1." beginnt, bleibt normaler Text.
- Links als {Linktext}{https://...} schreiben.
- Schlagwörter in "tags" durch Leerzeichen trennen, keine Kommas, kein Leerzeichen innerhalb eines Schlagworts.
- Wenn Sie Dateien erzeugen können, stellen Sie eine UTF-8-Datei mit dem Namen edumaps-map.json zum Herunterladen bereit, sonst geben Sie das JSON als Text aus. Das JSON muss syntaktisch gültig sein, ohne Erklärungen.
Inhalt der Map: (hier beschreiben, was die Map enthalten soll)

4. Laden Sie die fertige Datei unter „Edumaps-Datei importieren“ hoch.

Weiterführend

Den JSON-Import öffnen Sie auf der Seite „Edumaps-Datei importieren“ oder in der Seitenleiste über „Map erstellen“ → „Importieren“ → „Edumaps-Datei importieren“. Der Import setzt eine Anmeldung voraus und legt immer eine neue Map an, eine bestehende Map wird nie überschrieben. Die Export-Datei einer Map erhalten Sie über das Export-Menü der Map.

Export-Dateien können personenbezogene Daten enthalten, etwa in Box-Titeln, Box-Inhalten oder Notizen. Prüfen Sie die Datei, bevor Sie sie bei einem externen KI-Dienst hochladen.

Welche Schnittstellen Edumaps sonst bietet, steht in den häufigen Fragen.