Importieren
Markdown-Dateien und Word-Dokumente importieren Sie direkt in den Content Editor. So übernehmen Sie Inhalte aus externen Werkzeugen, Textdateien oder KI-Anwendungen, ohne sie von Hand nachzuformatieren. OpenOlat überführt den Inhalt automatisch in Blöcke der Seite. Ohne Import bauen Sie eine Seite Stück für Stück mit "Inhalt hinzufügen" auf. Wo Sie den Content Editor öffnen und wer ihn nutzt, beschreibt die Seite Content Editor.
Wichtig
Markdown ist ein verbreitetes Textformat, das viele Werkzeuge und KI-Anwendungen ausgeben. Überschriften, Listen und Tabellen sind darin als einfache Zeichen festgehalten, deshalb bleibt die Struktur eines Textes beim Import erhalten.
Klicken Sie zum Import auf den Button "Importieren" am unteren Rand des Content Editors.

Im Import-Dialog wählen Sie zwischen zwei Varianten:

A) Datei hochladen: Unterstützt werden:
- Markdown-Dateien (.md, .markdown, .txt)
- ZIP-Archive bis maximal 50 MB (Ein ZIP-Archiv muss genau eine Markdown-Datei enthalten und kann zusätzlich die darin relativ referenzierten Bilddateien mitliefern.)
- Word-Dokumente (.docx) bis maximal 200 MB .
B) Text einfügen: Sie fügen Markdown-formatierten Text direkt in das Eingabefeld ein, etwa aus der Zwischenablage. Lokale Bildpfade unterstützt dieser Modus nicht.
Darunter stehen, je nach Konfiguration des KI-Moduls, die Schalter "KI-generiertes Quiz hinzufügen" und "Bild-Metadaten mit KI generieren". Was sie bewirken, beschreiben die Abschnitte KI-Fragen beim Import erzeugen und Bilder beim Import.
Word-Dokumente importieren
OpenOlat wandelt Word-Dokumente beim Import automatisch in Markdown um. Danach durchlaufen sie dieselbe Verarbeitung wie Markdown-Dateien. Formatierungen wie hochgestellter, tiefgestellter, unterstrichener und hervorgehobener Text bleiben dabei ebenso erhalten wie Tabellen und eingebettete Bilder. Beim Hochladen einer .docx-Datei zeigt OpenOlat einen Hinweis an, da nicht alle Word-Funktionen übernommen werden können. Prüfen Sie die importierten Inhalte deshalb sorgfältig.
Umwandlung der Elemente
Beim Import wandelt OpenOlat die Markdown-Elemente so in Blöcke des Content Editors um:
| Markdown-Element | Block im Content Editor |
|---|---|
Überschrift (Ebene 1 bis 6, # bis ######) |
Titel in der entsprechenden Grösse (H1 bis H6) |
| Absatz | Text |
Trennlinie (---) |
Separator |
| Codeblock | Code-Beispiel (mit erkannter Programmiersprache) |
Blockzitat > |
Text mit Hinweis-Box |
GitHub-Admonition (z.B. > [!WARNING]) |
Text mit Hinweis-Box des passenden Typs |
| Liste (Aufzählung oder nummeriert) | Text mit Liste |
| Tabelle | Tabelle |
| Bild | Bild (Ablage im Media Center) |
Mathematischer Block ($$...$$) |
Mathematische Formel |
Inline-Formatierung <sup>, <sub>, <u>, <mark> oder ==Text== |
Text mit erhaltener Formatierung |
Bildgrösse {width=300 height=200} direkt nach dem Bild |
Bild in der angegebenen Anzeigegrösse |
| Tabelle mit fetter erster Zeile bzw. erster Spalte | Tabelle mit Zeilen- bzw. Spaltenüberschrift |
MkDocs-Admonition !!! info "Titel" |
Text mit Hinweis-Box des passenden Typs |
YAML-Metadatenblock am Dokumentanfang, durch --- eingefasst |
Wird erkannt und entfernt, die Seite beginnt direkt mit dem Inhalt |
Die Titelgrösse steuert zugleich, welche importierten Titel das Element "Inhaltsverzeichnis" erfasst und als Sprungmarken verlinkt.
Markdown-Erweiterungen
Zusätzlich werden die Markdown-Erweiterungen für durchgestrichenen Text, Task-Listen und Fussnoten unterstützt. GitHub-Admonitions der Typen NOTE, TIP, IMPORTANT, WARNING, CAUTION, INFO, SUCCESS und ERROR erhalten eine Hinweis-Box mit passendem Typ und Icon; bei MkDocs-Admonitions kommen weitere Typen wie ABSTRACT, HINT, QUESTION, ATTENTION, DANGER, BUG oder EXAMPLE hinzu. Ein Admonition-Titel in Anführungszeichen wird übernommen, ein leerer Titel "" blendet die Titelzeile aus, ohne Titelangabe erscheint die Standardbezeichnung des Typs. HTML-Blöcke übernimmt der Import aus Sicherheitsgründen nicht; er schliesst mit einer entsprechenden Warnung ab.
Bilder beim Import
Bilder legt OpenOlat beim Import direkt im Media Center ab. Eine Duplikatsprüfung verhindert, dass dasselbe Bild mehrfach im Media Center landet, ohne dass Sie als Autor:in etwas tun müssen.
Bilder mit absoluten URLs lädt OpenOlat beim Import herunter. Steht in der System-Administration unter Administration > Login > Sicherheit > Tab "Medien-Server" der Modus auf "Konfigurieren", gilt das nur für die dort freigegebenen Domänen. Ein Bild einer anderen Domäne lädt der Import nicht und meldet es als Warnung, siehe Tab Medien-Server. Auch direkt im Markdown eingebettete Base64-Bilder (Data-URIs) werden übernommen.
Ist in der System-Administration im KI-Modul die KI-Funktion "Bildbeschreibungs-Generator" eingeschaltet, steht im Import-Dialog der Schalter "Bild-Metadaten mit KI generieren". Ist er eingeschaltet, erzeugt OpenOlat für die importierten Bilder Titel, Beschreibung, Alternativtext und Tags im Hintergrund mit KI . Dabei überträgt OpenOlat eine verkleinerte Version jedes Bildes an den KI-Dienst. Ist er ausgeschaltet, erzeugt OpenOlat keine Metadaten mit KI. Die KI-Funktion liegt unter: Administration > Externe Werkzeuge > KI-Modul > Tab "KI-Funktionen".
Beim Öffnen des Dialogs steht der Schalter so, wie die KI-Bildbeschreibungen für Sie eingestellt sind: nach Ihrer Wahl im Tab KI-Einstellungen, ohne eigene Wahl nach der Vorgabe der Administration. Sie können ihn für jeden Import einzeln umstellen. Die Umstellung gilt nur für diesen Import, OpenOlat speichert sie nicht.
Details zu Metadaten mit KI >
Import an einer bestimmten Position
Der Button "Importieren" steht zusätzlich im Dialog "Inhalt hinzufügen" zur Verfügung . Über diesen Dialog fügt der Import den Inhalt genau dort ein, wo Sie gerade arbeiten: im jeweiligen Bereich des Layouts oder vor oder nach dem Inhaltselement, über das Sie den Dialog geöffnet haben. Über den Button am unteren Rand des Content Editors landen die Inhalte am Seitenende.

KI-Fragen beim Import erzeugen
Ist in der System-Administration im KI-Modul die KI-Funktion "Essay Fragen Generator" konfiguriert, steht im Import-Dialog zusätzlich der Schalter "KI-generiertes Quiz hinzufügen". Beim Öffnen des Dialogs ist er eingeschaltet. Die KI erzeugt die Fragen dann aus dem importierten Text, dem Lerntext: dem Text, den Ihre Lernenden durcharbeiten. OpenOlat fügt die Fragen als Quiz-Element direkt nach dem importierten Inhalt ein. Möchten Sie keine Fragen erzeugen lassen, schalten Sie ihn vor dem Import aus. Über die Felder "MC-Fragen" und "Essay-Frage mit KI-Korrektur" legen Sie fest, wie viele Fragen je Typ erzeugt werden (bis zu fünf pro Typ). Die Multiple-Choice-Fragen entstehen nur, wenn zusätzlich die KI-Funktion "MC Fragen Generator" konfiguriert ist. Das KI-Feedback zu den Freitextfragen liefert die KI-Funktion "Essay Bewertung". Alle drei KI-Funktionen liegen unter: Administration > Externe Werkzeuge > KI-Modul > Tab "KI-Funktionen".
Drei weitere Felder steuern, welche Fragen entstehen. Unter "Bloom-Stufen" wählen Sie, welche kognitiven Stufen die Fragen abdecken sollen: "Erinnern", "Verstehen", "Anwenden", "Analysieren", "Bewerten" und "Erschaffen". Die "Zielschwierigkeit" reicht von "1 - Sehr leicht (Quiz-Modus)" bis "5 - Sehr schwer"; mit "Keine Präferenz" wählt OpenOlat die Schwierigkeit je Frage zufällig. Im Feld "Lernziele (optional)" erfassen Sie ein Lernziel pro Zeile, um die Fragen inhaltlich zu fokussieren.

Wie lang der importierte Lerntext für die Fragengenerierung sein darf, gibt die System-Administration im KI-Modul vor, standardmässig 60000 Zeichen. Sind "MC Fragen Generator" und "Essay Fragen Generator" beide aktiv, gilt der kleinere der beiden Werte. Einen längeren Text weist der Dialog zurück.
Die Generierung läuft im Hintergrund und kann eine Minute dauern. Bis dahin steht an der Stelle ein Quiz-Element mit dem Titel "Bitte warten, Quiz Fragen werden per KI erzeugt.", danach erscheinen darin die Fragen. Prüfen Sie die erzeugten Fragen anschliessend auf inhaltliche Korrektheit. Im E-Portfolio steht die KI-Fragengenerierung nicht zur Verfügung.
Weiterführende Informationen
Auf dieser Seite erwähnt
Inhalt hinzufügen >
Content Editor >
Layout >
Sicherheit >
Externe Werkzeuge: KI-Modul >
Persönliche Konfiguration: Einstellungen >
Media Center: Informationen und Einstellungen zu Einzelmedien >
Quiz und KI-Feedback >
Weiterführend
Media Center: Konzept >