Import Markdown files into Docs

With the Markdown importer, you can import Markdown files (.md) into awork, either as new Docs in a location you choose or directly into an existing Doc.

---

Key benefits and use cases

With Markdown Import, you can bring your Markdown content directly into awork. You can choose whether to create new Docs or add content to an existing Doc.

• Create new Docs: Import one or more Markdown files (.md) into a Space, a project, or your private area.

• Add to existing Docs: Append Markdown content to an existing Doc or replace its current content.

• Convert content automatically: awork automatically converts the imported Markdown content into Doc content.

• Preserve formatting: Supported Markdown formatting is preserved during import. For Markdown files exported from awork, supported references and rich content are also restored. Missing files and comments are not recreated.

---

Import Markdown files as new Docs

You can open the import dialog in several ways. Choose the option that best fits your current workspace.

Requirements

Access to the importer: You need admin permissions or access to the workspace settings.

Create new Docs: You need permission to create Docs in the location you choose.

Add to existing Docs: You need edit access to the Doc.

Open the import dialog

Option 1: From the importer in settings

1. Go to Einstellungen (the gear icon at the bottom left of the main menu)

2. Under Integrationen, select Importer

3. On the Markdown card, click Import starten

Option 2: From the Docs home page

1. Go to Docs in the main menu

2. In the action bar at the top right, click the Docs importieren icon

3. Select Aus Markdown importieren

Option 3: From a Docs Space

1. Open the Aktionsmenü in a Space
2. Select Aus Markdown importieren

Option 4: In a project

1. Open a project
2. Go to the Docs tab
3. In the action bar at the top right, click the Docs importieren icon
4. Select Aus Markdown importieren

The Docs aus Markdown importieren dialog opens.

Choose a location

1. Next to Wähle einen Speicherort, click Durchsuchen or check the preselected location.

2. In the selection window, choose the area you want:

• Space – Import the Docs into a Space

• Projekt – Import the Docs into a specific project

• Privat – Import the Docs into your private area

3. Go to the destination you want and confirm by clicking Auswählen

You can also optionally select an existing Doc as the parent Doc.

Add Markdown files

1. In the Markdown-Dateien (.md) section, drag and drop the files you want into the Dateien hier ablegen field, or click the area to select Markdown files using the file browser.

2. Check the filenames shown in the dialog after you select them.

Start the import and check the results

1. Click Importieren to start the process.

2. Wait for awork to process all the files.

3. Check the import confirmation and the links to the Docs that were created.

4. Click Schließen to close the dialog.

awork imports the files one by one. You can't select files while they're being processed.

---

Import Markdown into an existing Doc

You can add the contents of a Markdown file directly to an existing Doc. You need edit access to the Doc to do this.

1. Open the Doc you want and click the Aktionsmenü in the top right. Alternatively, hover over a Doc in the Docs list and open its action menu.

2. Select Markdown einfügen

3. Drag a Markdown file into the highlighted area, or click the area to select a file.

4. Optionally, check Bestehenden Inhalt ersetzen

   1. Bestehenden Inhalt ersetzen: Replaces the current Doc content with the imported Markdown content.
   2. Leave the option unchecked: Adds the imported Markdown content to the existing content.

5. Click Importieren

The dialog closes automatically after the import is complete. The imported content is then available in the existing Doc.

---

Troubleshooting tips

• The Markdown import option isn't available: Make sure you have permission to create or edit Docs in the location you want. To access the importer through Einstellungen → Importer, you need admin permissions or access to the workspace settings.

• The import won't start: If you haven't selected a file, awork displays an error when you try to import. Add at least one Markdown file (.md) before starting the import again.

• A file is rejected: The importer only accepts Markdown files with the .md extension. Other file types aren't accepted.

• File selection is disabled: You can't select files while awork is processing them. The files are imported one at a time. When the import is complete, check the confirmation and the links to the Docs that were created.

---

FAQ

Can I import multiple Markdown files at once?

Yes. When creating new Docs, you can select multiple .md files at once. A separate Doc is created for each file, using the filename as its name. When importing Markdown into an existing Doc, you can only select one file per import.

Where can I find the imported Docs?

You'll find new Docs in the location you selected during import. If you import Markdown into an existing Doc, the content is added directly to that Doc.

Will the existing content of a Doc be overwritten?

That depends on your selection. If you enable Bestehenden Inhalt ersetzen, the current content is replaced. If you leave the checkbox unchecked, the imported content is appended.

What happens to the Markdown content during import?

awork automatically converts the imported Markdown content into Doc content. Supported Markdown formatting is preserved.