Skip to content

By using this website, you agree to our use of cookies. We use cookies to provide you with a great experience and to help our website run effectively.

🎁 Launch offer. 20% off any plan. Use Code: SPECIAL20 🎁

Migrate or import to ByDesign

Moving to ByDesign is quick. Import your notes from any app that exports Markdown, like Notion or Obsidian: each file becomes a page, with checkboxes turned into tasks. Your calendars come in by connecting Google, Apple or Outlook, not by uploading a file.

Updated November 17, 2026.

What you can bring in

  • Markdown files (.md), each as a page.
  • A .zip of Markdown files, like an export from Notion or an Obsidian vault, to bring in many pages at once, with their folders and images.
  • Your Google, Apple and Outlook calendars, by connecting them. Google and Apple sync both ways; Outlook syncs one way.
  • Any other calendar that has a subscription link.

Export from your old app

  • Notion: on the page you want, open the ••• menu, choose Export, pick Markdown & CSV and include subpages. Notion gives you a .zip.
  • Obsidian: your notes are already .md files in your vault folder. Zip the folder: on a Mac, right-click it and choose Compress; on Windows, right-click it and choose Compress to ZIP file, or Send to → Compressed (zipped) folder.
  • Any other app: export your notes as Markdown. One note can go in as a .md file; for many notes, zip them together.

Import your files

  1. Step 1: Open your Workspace

    Go to the Workspace in ByDesign on the web or in the desktop app.

  2. Step 2: Open the import

    Open the create menu and choose Import (Markdown).

  3. Step 3: Upload

    Click Browse to Upload and choose your .md or .zip file.

  4. Step 4: Find your pages

    When the import finishes, your pages are in a folder called ⬇️ Imports in your Workspace, fully editable.

The + next to Workspace opens a menu with New Page, New Folder and Import (Markdown)
ByDesign’s Import (Markdown) window: upload a .md file, or a .zip if your export includes nested pages or images, with a Browse to Upload button

Tip

If your export has several files or nested pages, zip them: folders in the .zip become nested pages, so the structure stays intact.

What comes across

  • Each .md file becomes a page, and folders in a .zip become nested pages.
  • Checkbox lines (- [ ] and - [x]) become tasks, ticked or not, ready to schedule.
  • Headings, text, bullet lists, numbered lists, tables, quotes and code are kept.
  • Images in .jpg, .png, .gif or .webp are uploaded with your pages.

Note

Only Markdown files and those images are imported. Other files are left out, including CSV files, like Notion databases, and PDFs.

After you import

  • Drag your pages out of ⬇️ Imports into your own folders, like Personal and Work.
  • Give your new tasks a date, or drag them onto the calendar to block out time for them.
  • Star the pages you use most, so they’re one click away.

Bring in your calendars

  1. Step 1: Open your settings

    In ByDesign, open Settings, then Calendar's Integrations.

  2. Step 2: Add a calendar

    Under Add Calendars, choose Google, Outlook or Apple and connect your account.

  3. Step 3: Choose where ByDesign pushes

    Pick a calendar for Push my events/ tasks/ habits to this calendar, so your ByDesign items appear there too.

ByDesign’s Calendars and Integration settings: Email Tasks to Your Inbox, Add Calendars with Google, Outlook, Apple and Subscribe, Manage Calendars, and Push my events/ tasks/ habits to this calendar, with the addresses blurred
  • Google: full two-way sync for your primary Google calendar. Add, edit or delete on either side and both stay up to date.
  • Apple: two-way sync as well.
  • Outlook: one way. You see your Outlook events in ByDesign and your ByDesign tasks and events in Outlook, but moving an Outlook event in ByDesign doesn’t change it in Outlook.
  • Subscribe: add any other calendar from its subscription link to see its events in ByDesign.

Use Manage Calendars to show or hide each calendar. There’s no calendar file (.ics) to upload: connect or subscribe instead.

If something goes wrong

  • An import fails: check that you chose a .md file or a .zip of .md files, and that no .md file is over 5,000 lines or 1,000,000 characters. Split very long notes into smaller files.
  • Dragging a file onto the import window does nothing: drag and drop isn’t supported there, so use Browse to Upload.
  • Calendar events are missing or out of date: remove the calendar in Calendar's Integrations, then connect it again. If that doesn’t help, message us from the chat in the app.

Good to know

  • Each .md file can have up to 5,000 lines and 1,000,000 characters.
  • All-day tasks, events and habits go to your external calendar only if you turn on Sync with external calendars in Settings → Customizations.
  • Students can also connect Canvas, under Other Integrations in the same settings, to bring in the Canvas calendar and course materials.

Keep reading

← All help topics

Still need help?

Our team answers questions in the app’s chat, by email and on Discord.