Agenda

Agenda can export or copy notes in Markdown, but it is not a folder-first Markdown app. The best migration path is to export projects or selected notes in batches, then organize the exported Markdown files into an Octarine workspace.

Export from Agenda

Select the project, category, or notes you want to move. On Mac, use File > Export when available, or use Edit > Copy As > Markdown for selected notes.

Agenda may not export the whole library as Markdown in one step, so plan to migrate one project or category at a time. For notes with images or attachments, TextBundle can be useful as a temporary export package, but you will need to extract the Markdown and assets before moving them into Octarine.

Create an Octarine Workspace

Create a migration folder and add each exported batch to it. A simple structure is:

Agenda Export/
  Work/
  Personal/
  Archive/

Open Octarine and click the Workspace Switcher in the top-left corner. Select Create Workspace, give it a name, and toggle Use an existing folder?. Choose your Agenda export folder and press Create.

Dates and Projects

Agenda's timeline, projects, and calendar links are part of Agenda's app model. In Octarine, represent the pieces you still need with folders, tags, note properties, or daily notes.

For dated notes, consider moving them into the Daily folder and renaming them to Octarine's daily note format:

YYYY-MM-DD.md

Attachments

Move exported images and files into a .attachments folder at the root of your Octarine workspace. Then update links in the Markdown files so they point to the moved files.

If you exported TextBundle files, extract the Markdown and collect the bundled assets into .attachments. Octarine does not import .textbundle files directly.

Compatibility Notes

Markdown text, headings, lists, and checklists should move cleanly. Agenda-specific project status, scheduled dates, calendar event links, people, notes-on-the-agenda state, and internal Agenda links do not transfer directly.

After each batch, open a few notes in Octarine and check the links, dates, and attachments before exporting the next batch.