Markdown-Dateien in Docs importieren

Mit dem Markdown Importer kannst du Markdown-Dateien (.md) in awork importieren – entweder als neue Docs in einen gewählten Speicherort oder direkt in ein bestehendes Doc.

---

Hauptvorteile und Anwendungsfälle

Mit dem Markdown Import bringst du deine Markdown-Inhalte direkt nach awork. Du entscheidest, ob du neue Docs erstellen oder Inhalte in ein bestehendes Doc übernehmen möchtest.

• Neue Docs erstellen: Importiere eine oder mehrere Markdown-Dateien (.md) in einen Space, ein Projekt oder deinen privaten Bereich.

• Bestehende Docs ergänzen: Füge Markdown-Inhalte an ein vorhandenes Doc an oder ersetze dessen bisherigen Inhalt.

• Inhalte automatisch umwandeln: awork wandelt den importierten Markdown-Inhalt automatisch in Doc-Inhalt um.

• Formatierungen übernehmen: Unterstützte Markdown-Formatierungen bleiben beim Import erhalten. Bei Markdown-Dateien aus awork-Exporten werden außerdem unterstützte Referenzen und Rich Content wiederhergestellt. Fehlende Dateien und Kommentare werden nicht neu erstellt.

---

Markdown-Dateien als neue Docs importieren

Du kannst den Importdialog auf verschiedenen Wegen öffnen. Wähle den Weg, der am besten zu deinem aktuellen Arbeitsbereich passt.

Voraussetzungen

Zugriff auf den Importer: Du benötigst Admin-Rechte oder Zugriff auf die Workspace-Einstellungen.

Neue Docs erstellen: Du benötigst die Berechtigung, am gewählten Speicherort Docs zu erstellen.

Bestehende Docs ergänzen: Dafür benötigst du Bearbeitungszugriff auf das jeweilige Doc.

Importdialog öffnen

Variante 1: Über den Importer in den Einstellungen

1. Navigiere zu den Einstellungen (Zahnradsymbol links unten im Hauptmenü)

2. Wähle unter Integrationen den Eintrag Importer

3. Klicke auf der Markdown-Karte auf Import starten

Variante 2: Über die Docs-Hauptseite

1. Navigiere zu den Docs im Hauptmenü

2. Klicke in der Aktionsleiste oben rechts auf das Icon Docs importieren

3. Wähle Aus Markdown importieren

Variante 3: Über einen Docs-Space

1. Öffne das Aktionsmenü ein einem Space
2. Wähle Aus Markdown importieren

Variante 4: In einem Projekt

1. Öffne ein Projekt
2. Navigiere zum Docs-Tab
3. Klicke in der Aktionsleiste oben rechts auf das Icon Docs importieren
4. Wähle Aus Markdown importieren

Der Dialog Docs aus Markdown importieren öffnet sich.

Speicherort auswählen

1. Klicke neben Wähle einen Speicherort auf Durchsuchen oder prüfe den vorausgewählten Speicherort.

2. Wähle im Auswahlfenster den gewünschten Bereich:

• Space – Importiere die Docs in einen Space

• Projekt – Importiere die Docs in ein bestimmtes Projekt

• Privat – Importiere die Docs in deinen privaten Bereich

3. Navigiere zum gewünschten Ziel und bestätige mit Auswählen

Optional kannst du auch ein bestehendes Doc als übergeordnetes Doc auswählen.

Markdown-Dateien hinzufügen

1. Ziehe im Bereich Markdown-Dateien (.md) die gewünschten Dateien per Drag & Drop ins Feld Dateien hier ablegen oder klicke auf die Fläche, um Markdown-Dateien über den Datei-Explorer auszuwählen.

2. Prüfe die Dateinamen, die nach der Auswahl im Dialog angezeigt werden

Import starten und Ergebnis prüfen

1. Klicke auf Importieren, um den Vorgang zu starten

2. Warte, bis awork alle Dateien verarbeitet hat

3. Prüfe die Importbestätigung und die Links zu den erstellten Docs.

4. Klicke auf Schließen, um den Dialog zu schließen

awork importiert die Dateien der Reihe nach. Während der Verarbeitung ist die Dateiauswahl gesperrt.

---

Markdown in ein bestehendes Doc importieren

Du kannst den Inhalt einer Markdown-Datei direkt in ein bestehendes Doc übernehmen. Dafür benötigst du Bearbeitungszugriff auf das Doc.

1. Öffne das gewünschte Doc und klicke oben rechts auf das Aktionsmenü (Alternativ kannst du in der Docs-Liste über ein Doc fahren und dort das Aktionsmenü öffnen)

2. Wähle Markdown einfügen

3. Ziehe eine Markdown-Datei in die markierte Fläche oder klicke auf die Fläche, um eine Datei auszuwählen

4. Setze optional ein Häkchen für Bestehenden Inhalt ersetzen

   1. Bestehenden Inhalt ersetzen: Der bisherige Doc-Inhalt wird durch den importierten Markdown-Inhalt ersetzt
   2. Option deaktiviert lassen: Der importierte Markdown-Inhalt wird an den bestehenden Inhalt angehängt

5. Klicke auf Importieren

Nach erfolgreichem Import schließt sich der Dialog automatisch. Der importierte Inhalt ist anschließend im bestehenden Doc verfügbar.

---

Tipps zur Fehlerbehebung

• Die Option Markdown-Import ist nicht verfügbar: Stelle sicher, dass du die Berechtigung hast, am gewünschten Speicherort Docs zu erstellen oder zu bearbeiten. Für den Zugriff über Einstellungen → Importer benötigst du Admin-Berechtigungen oder Zugriff auf die Workspace-Einstellungen.

• Der Import lässt sich nicht starten: Wenn du keine Datei ausgewählt hast, zeigt awork beim Importversuch eine Fehlermeldung an. Füge mindestens eine Markdown-Datei (.md) hinzu, bevor du den Import erneut startest.

• Eine Datei wird abgewiesen: Der Importer akzeptiert nur Dateien im Markdown-Format mit der Endung .md. Andere Dateitypen werden nicht angenommen.

• Die Dateiauswahl ist gesperrt: Während awork die Dateien verarbeitet, ist die Dateiauswahl deaktiviert. Die Dateien werden nacheinander importiert. Prüfe nach Abschluss die Importbestätigung und die Links zu den erstellten Docs.

---

FAQ

Kann ich mehrere Markdown-Dateien gleichzeitig importieren?

Ja. Beim Erstellen neuer Docs kannst du mehrere .md-Dateien gleichzeitig auswählen. Für jede Datei wird ein eigenes Doc erstellt, dessen Name dem Dateinamen entspricht. Wenn du Markdown in ein bestehendes Doc importierst, kannst du pro Import nur eine Datei auswählen.

Wo finde ich die importierten Docs?

Die neuen Docs findest du am Speicherort, den du beim Import ausgewählt hast. Wenn du Markdown in ein bestehendes Doc importierst, wird der Inhalt direkt dort eingefügt.

Wird der bestehende Inhalt eines Docs überschrieben?

Das hängt von deiner Auswahl ab. Wenn du Bestehenden Inhalt ersetzen aktivierst, wird der bisherige Inhalt überschrieben. Bleibt die Checkbox deaktiviert, wird der importierte Inhalt angehängt.

Was passiert mit dem Markdown-Inhalt beim Import?

awork wandelt den importierten Markdown-Inhalt automatisch in Doc-Inhalt um. Unterstützte Markdown-Formatierungen bleiben dabei erhalten.