Import Markdown notes

Use this guide to bring existing Markdown notes into an Atlas project so they become searchable, mentionable material.

What this page covers

Import entry point, supported Markdown behavior, merge or replacement rules, completion, and failure recovery.

Before you start

Review your files before importing. Remove private drafts, unrelated notes, duplicates, and files that belong in a different project.

Use clear, descriptive filenames. Atlas can preserve or infer a note title from the filename, so a clear name makes it easier to identify notes after import.

Steps

1. Open the destination project.
2. Select the note import option from the note creation menu.
3. Choose a single Markdown file or a folder of Markdown files.
4. Wait for the import to finish.
5. Open the imported notes list and review the results.

Check the imported notes

After import, open several high-value notes and confirm:

• Headings, bullets, and task lists look correct.
• Tables and code blocks render as expected.
• Any links still point to the right places.
• Math or special formatting appears correctly if you use it.

Markdown differs across editors. Review the first import for structure, links, formatting, and source mentions before importing the rest.

After import

Search for an imported note to confirm it is findable. Mention it in chat using @ when you want Atlas to use it as context for an answer.

If imported notes reference sources that are already in the project, add @ mentions to connect them.

Troubleshooting