notesnook/docs/help/contents/importing-notes/import-notes-from-markdown-files.md

---
title: Markdown files
---

# How do I import notes from Markdown files?

1. Go to [https://importer.notesnook.com/](https://importer.notesnook.com/) on your PC/Laptop.
2. From the list of note apps to import from, select "Markdown".
   ![](/static/markdown-importer/1.png)
3. Drop your .md files, or click anywhere inside the box to browse and select your .md files. You can also provide a .zip file containing all your .md files. Then click "Start processing".
   ![](/static/markdown-importer/2.png)
4. Once the Importer finishes processing your files, download the .zip file.
   ![](/static/import-ready.png)
5. After you have downloaded the `.zip` file, [go to the Notesnook Web App](https://app.notesnook.com/) > Settings > Notesnook Importer. Select the .zip you downloaded earlier and click "Start import" button.
   ![](/static/import-zip-app.png)
6. Once importing completes you should see all your notes in Notesnook. If you face any issues during importing, feel free to [report them on GitHub](https://github.com/streetwriters/notesnook-importer).

## Supported formats

- [x] 100% support for CommonMark syntax
- [x] GitHub flavored markdown (task lists, tables etc.)
- [x] Obsidian flavored markdown (embedded files, comments etc.)
- [x] Subscript and superscript (`H~2~O` and `19^th^`)
- [x] Highlights (`==highlighted==`)
- [x] Images and links (links that point to files get added as attachments)

> Note: For best results, it is recommended to ZIP all your .md files and their attachments so they can be found by the importer.