Import Markdown and text notes

Atlas turns .md and .txt files into notes in your current project. You can import them from the New menu or use an authenticated workspace file picker, dropzone, or clipboard paste.

Import files from the New menu

1. Open the project where you want the notes.
2. Select New in the left sidebar.
3. Point to Note to open its submenu.
4. Select Markdown or text.
5. Choose the .md or .txt files you want to import.

Atlas creates the notes and shows how many were uploaded.

Import a folder

If the Note submenu includes Folder:

1. Select New in the left sidebar.
2. Point to Note.
3. Select Folder.
4. Choose the folder that contains your Markdown or text files.

Atlas imports .md and .txt files from the selected folder. Other file types are skipped.

Import from chat or another file surface

In a signed-in project, you can also select, drop, or paste .md and .txt files where Atlas accepts workspace files. Atlas creates project-root notes instead of sources, so these files do not use source capacity.

When you import from chat, Atlas inserts one note mention for each created note at the composer position. When you drop the files into the note editor, Atlas inserts note citations at the drop position. Supported source files and chat attachments in the same batch continue through their usual paths.

Titles and folder structure

Atlas uses each filename without .md or .txt as the note title. If that title already exists, Atlas adds a number to the imported title instead of replacing the existing note.

The file contents become the note body without escaping or a code block. Markdown syntax in either file type renders as note formatting.

For a folder import, Atlas also creates notes for folders. Each folder note contains links to the notes created from its files and subfolders.

If the import stops

An import can create some notes before an error stops the remaining work. The error message states how many notes Atlas created.

Check the project for those notes before you retry. Then import only the files that are still missing.

If Atlas reports No Markdown or text files found in selected folder, choose a folder that contains files ending in .md or .txt.