You can start with no pages or bring notes you already have. Markdawn can import one markdown file, a markdown folder, or an Obsidian vault.

## Before You Begin

Have the file, folder, or Obsidian vault available on the computer where you are using Markdawn. Keep an untouched copy of the original until you have checked the imported pages.

Other note-taking apps have not been tested as first-class imports. If an app exports a markdown folder, you can try importing that folder.

## Import Your Notes

When Markdawn asks how you want to get started, choose **Import Content**.

- Choose **markdown file** for one `.md` file.
- Choose **markdown folder** for notes stored as files and folders.
- Choose **Obsidian vault** to import notes, images, and links between pages.

## Verify The Import

After the import finishes, open a few pages and check:

1. The page title is correct.
2. The main text is present.
3. Images appear where you expect them.
4. Links open the intended pages.
5. The folder structure is useful.

The import is ready when representative pages have the right titles, readable content, working links, and expected images.

## If Something Looks Wrong

- If a title is wrong, rename the page in Markdawn after checking the source filename.
- If an image is missing, confirm that the image was inside the imported folder and that the source markdown used a supported image link.
- If a link opens the wrong page, check the page title and fix the link after the import.
- If the folder structure is too large, keep the imported pages and reorganize them gradually instead of moving everything at once.

## After The Import

Start with one small cleanup pass:

- Rename pages whose titles are unclear.
- Create folders for projects you actively use.
- Fix links that point to pages you no longer need.
- Add a short note to pages that are important but unfinished.

Do not reorganize everything at once. Keep using Markdawn and improve the structure when you notice a real problem.

For the syntax available after importing, see [Markdown Support](/getting-started/markdown-support/). For a repeatable terminal workflow, see [Markdawn CLI](/agents/markdawn-cli/).