# Import from Roam

> Export a Roam Research Note Open Roam Research and click the ☰ All Pages button on the left. Check the boxes next to the notes you want to export. Check the top...

- Source: https://www.taskade.com/learn/import/roam
- Section: Import
- Updated: 2026-09-15
- Index of all pages: https://www.taskade.com/learn/llms.txt

## Overview

Roam Research is a networked note-taking tool popular for its bidirectional linking and daily notes workflow. To move your knowledge base to Taskade, export your Roam pages as Markdown files. Then import them in a few steps. Your notes become part of your Taskade workspace. Organize them into projects, view them in [multiple project views](https://www.taskade.com/learn/projects/project-views), and enhance them with [AI agents](https://www.taskade.com/learn/agents/custom-agents).

> **TL;DR:** Bring your Roam Research graph into Taskade by exporting your pages as Markdown, then dropping the .md files into the Import with AI tab. Each page becomes a project you can view in [Mind Map](https://www.taskade.com/learn/projects/mindmap-view), and you can reconnect linked notes through Taskade's [project hierarchy](https://www.taskade.com/learn/projects/hierarchy-structure).

---

## Export a Roam Research Note

1. Open Roam Research and click the **☰ All Pages** button on the left.
2. Check the boxes next to the notes you want to export.

   - Check the top box to **Select All** your notes.
3. Click the **export button 📤** and choose **Markdown**.
4. Save the downloaded file to your computer. Roam exports each page as an individual **.md** file inside a ZIP archive.
5. Unzip the archive to access the individual Markdown files.

---

## Import to Taskade

1. Go to your workspace or folder.
2. Click the arrow next to the ➕ **New Project** button.
3. Select **Import**, then drag your Roam Research **.md** files into the **Import with AI** tab. To paste content instead, click **Paste Text & Markdown**.

   ![Selecting the Import with AI tab in the Taskade Import dialog](https://www.taskade.com/static_images/learn/import/roam-201cb92c.png)

   - You can select multiple files at once.
4. Click **Create Project** to finish.

![Dragging Roam Markdown files into the Import with AI tab](https://www.taskade.com/static_images/learn/import/roam-11c6194e.gif)

🧠 Each Roam page becomes a project you can open in Mind Map view to see your outline branch out:

```
         ● Project Plan
         │
   ┌─────┼──────┐
 Goals  Tasks  Notes
```

The block hierarchy from Roam carries over, so the branches match the structure you already built.

---

## After Import

After your Roam notes land in Taskade, use these features to organize and extend your content:

- **Switch views**: Toggle between [List](https://www.taskade.com/learn/projects/list-view), [Mind Map](https://www.taskade.com/learn/projects/mindmap-view), [Board](https://www.taskade.com/learn/projects/board-view), and other views to see your notes from different angles.
- **Use AI to restructure**: Ask [Taskade AI](https://www.taskade.com/learn/agents/agent-chat) to summarize, rewrite, or reorganize imported notes.
- **Add to agent knowledge**: Upload your imported notes as [agent knowledge](https://www.taskade.com/learn/agents/knowledge) so your custom AI agents can reference them in conversations.
- **Collaborate in real time**: Share your workspace with teammates and edit notes together with [real-time collaboration](https://www.taskade.com/learn/projects/collaboration).

---

## Tips

- For a complete backup of your Roam graph, export all pages at once.
- Roam's `[[wikilinks]]` arrive as plain text. Use Taskade's [project hierarchy](https://www.taskade.com/learn/projects/hierarchy-structure) to reconnect related notes.
- For large exports, import notes into separate [folders](https://www.taskade.com/learn/projects/team-folders) organized by topic.

---

For more on turning notes into agent knowledge and automations, see [Custom AI Agents/GPTs](https://www.taskade.com/blog/custom-ai-agents-gpts).

## Roam Field Mapping

| Roam | Taskade Equivalent |
| --- | --- |
| Page | Project |
| Block | Task / Sub-task |
| `[[Page]]` | [Hierarchy](https://www.taskade.com/learn/projects/hierarchy-structure) |
| `((block-ref))` | Plain text (re-link) |
| Tag (#) | Tag |
| TODO | Task |
| Daily Notes | Project per date in folder |

### Carries over vs needs cleanup

- **Imports cleanly**: Block hierarchy, headings, plain text, TODO/DONE markers.
- **Needs cleanup**: Bidirectional links (rebuild with internal links), block embeds, Roam queries (recreate as [agent prompts](https://www.taskade.com/learn/agents/agent-chat)).

## How the Import Works

```mermaid
flowchart LR
    A[Roam Graph] -->|Export Markdown| B[ZIP of .md]
    B -->|Upload| C[Taskade Importer]
    C --> D[One Project per Page]
    D --> E[Mind Map View]
    D --> F[Agent Knowledge]
    style A fill:#1a0d24,color:#ce93d8,stroke:#6a1b9a,stroke-width:1.5px
    style C fill:#2a1225,color:#ff8fa3,stroke:#ff2d60,stroke-width:2px
    style F fill:#0d1a0e,color:#86efac,stroke:#22c55e,stroke-width:1.5px
```

## Bring It Into Taskade Genesis

Your imported graph is now part of your Workspace DNA. Open the project's **···** menu and choose **Add to Agent Knowledge** so a [custom agent](https://www.taskade.com/learn/agents/custom-agents) answers questions from it. Start an [automation](https://www.taskade.com/learn/automation/triggers) from the project to act on new or changed tasks. Then open [Taskade Genesis](https://www.taskade.com/create) and describe the app you want on top of that data, such as a research tracker, a knowledge base, or a client portal. For a web page or a video you want to keep alongside it, save the link in the Media Files tab (see [Import a Website URL](https://www.taskade.com/learn/import/website-url)).

### Related guides

- [Import CSV Spreadsheets](https://www.taskade.com/learn/import/csv-import)
- [Summarize with AI](https://www.taskade.com/learn/import/summarize)
- [Import from Obsidian](https://www.taskade.com/learn/import/obsidian)
- [Import from Logseq](https://www.taskade.com/learn/import/logseq)
- [Build an app with Taskade Genesis](https://www.taskade.com/create)
- [Explore AI agents](https://www.taskade.com/agents)
