Export

Mudlark is where thoughts start, not where they have to stay. Export full notes to writing apps, or just the tasks to your task manager. Set up destinations in Settings › Export.

How to export

  1. Add a destination in Settings › Export. Each destination has its own format, folder, and connection settings.
  2. Press  ⌘E  (or use the menu) to export the current note. If you have multiple destinations, Mudlark asks which one to use.
  3. For tasks only, use the task export option in the menu. Mudlark extracts tasks (with sub-tasks and completion state) and sends them to your task manager.

Formats

Markdown. Standard Markdown output. Each destination gets a tailored “flavor”: Bear removes extra blank lines around headings, Ulysses bumps heading levels, and so on. The differences are automatic.
Rich Text. RTF with full styling. Useful for pasting into apps that don’t understand Markdown.
Plain text. Your raw source text with prefix characters included. What you typed, exactly.
Apple Notes. A native format with checklists, styled text, and inline images. Completed tasks become checked items.

Note destinations

These export the full note content. You can add multiple destinations and choose between them at export time.

Obsidian

via URL scheme

Setup: Enter your vault name and an optional folder path (e.g. Notes/Inbox). If you leave the vault blank, Mudlark uses your last-opened vault.

Images: Enable “Include media in export” and select your vault’s root folder. Mudlark copies images there and uses relative paths in the Markdown so they render correctly in Obsidian.

Mudlark generates Obsidian-flavored Markdown: highlights, questions, and custom callouts use Obsidian’s > [!type] callout syntax. If you use custom callouts, click “Copy Callout CSS” in Settings and paste the result into your vault’s .obsidian/snippets/ folder, then enable it in Obsidian’s Appearance settings.

iA Writer

via URL scheme

Setup: Enter a library path (e.g. /Locations/iCloud) or leave blank for the root.

Images: Enable “Include media in export” and select your iA Writer library root. Images are copied there with relative paths in the Markdown.

Bear

via URL scheme (x-callback-url)

Setup: Optionally enter comma-separated tags (e.g. work, notes). Tags are applied to every export.

Images: Images are uploaded individually via x-callback-url chaining. Each image must be under 3 MB; larger images are skipped.

Bear gets its own Markdown flavor: extra blank lines around headings are removed and consecutive blank lines are collapsed.

Ulysses

via URL scheme (x-callback-url)

Setup: Optionally enter a group name or path (e.g. Writing/Blog).

Images: Images are sent as sheet attachments (not inline). Supported formats: JPG, PNG, GIF, PDF, RAW.

Ulysses gets its own Markdown flavor: heading levels are bumped down by one (# becomes ##) and table alignment markers are stripped for compatibility.

Craft

via URL scheme (deeplink)

Setup:

  1. In Craft, right-click the folder you want to export into
  2. Select “Copy Deeplink”
  3. Paste the deeplink into Mudlark’s settings

Mudlark parses the space and folder IDs from the deeplink automatically. This method is text-only. For image support, use Craft API instead.

Craft API

via REST API

Setup:

  1. Open Craft and go to the Imagine tab (top-right)
  2. Click “Add API Connection”
  3. Set permission level to “Read & Write”
  4. Copy the Endpoint URL and API Key from the modal
  5. Paste both into Mudlark’s settings

The API key (starts with pdk_) is stored securely in your Mac’s Keychain. The connection is verified automatically when you save.

Images: Full support. Images are uploaded and interleaved with text blocks. Files over 3 MB are skipped.

Apple Notes

via clipboard (native format)

Setup: Optionally enter a target folder name in Notes. No other configuration needed.

When you export, Mudlark copies your note in Apple Notes’ native RTF format, opens Notes, and pastes automatically. Tasks become native checklists (completed tasks show as checked).

Images: Images are embedded inline as base64. For large notes with many images, you can toggle this off in Settings to keep exports fast.

Apple Notes (Shortcut)

via Apple Shortcuts

Setup:

  1. In Mudlark’s export settings, click “Install Shortcut” to open the pre-built “Mudlark to Apple Notes” shortcut
  2. Add it to your Shortcuts library
  3. Click “Test Export” in Mudlark to verify it works

This method uses an HTML-based export for richer formatting. It’s useful if the standard clipboard method doesn’t work for your setup, or if you want to customize the shortcut (e.g. to route notes to a specific folder).

You can also create your own shortcut: the only requirements are Get Clipboard and Create Note actions. Enter your custom shortcut’s name in the settings.

Notion

via REST API

Setup:

  1. Go to notion.so/profile/integrations and create a new internal integration
  2. Grant it “Insert Content” permission
  3. In Notion, open the page you want to export into, click the menu, select Connections, and add your integration
  4. In Mudlark’s settings, paste the Integration Secret (starts with ntn_)
  5. Paste the Parent Page URL (the full Notion URL or just the page ID)
  6. Click “Test Connection” to verify

The token is stored in your Mac’s Keychain. Mudlark converts your note into native Notion blocks: headings, to-do items, bulleted lists, numbered lists, quotes, code blocks, callouts, and tables.

Images: Uploaded directly to Notion via the file upload API. Video is not supported.

Common errors: “Invalid or expired token” means the integration secret is wrong. “Page not found” means the page isn’t shared with the integration. Open the page in Notion and add the connection.

Custom folder

via file system

Setup: Click “Choose…” and select any folder on your Mac. Mudlark saves a bookmark so it can write to this folder across launches without asking again.

Notes are saved as .md files named after the note title. Existing files with the same name are overwritten.

Clipboard

via system pasteboard

No setup needed. Copies the note in all available formats at once (plain text, Markdown, Rich Text, and HTML) so the receiving app picks the richest version it supports.

Task destinations

These export only the tasks from a note. Named blocks become parent tasks with sub-tasks. Completion state is preserved. You can choose whether to include already-completed tasks.

Todoist

via REST API (OAuth)

Setup: Click “Sign in” to connect your Todoist account via OAuth. Optionally choose a project to export into.

Named blocks in your note become parent tasks, with the lines inside them as sub-tasks. Completed tasks are marked as complete in Todoist.

Things

via URL scheme

Setup: Optionally enter a list name and tags. No sign-in needed. Things uses a URL scheme.

Uses Things’ JSON URL scheme for batch import, so all tasks arrive at once. Sub-task hierarchy is preserved.

Apple Reminders

via EventKit

Setup: Optionally choose a Reminders list. Mudlark will ask for Reminders access the first time you export (System Settings › Privacy & Security › Reminders).

Creates individual reminders. List matching is case-insensitive, so “Work” and “work” both match the same list.

TickTick

via REST API (OAuth) or URL scheme

Setup: Click “Sign in” to connect your TickTick account via OAuth. Optionally choose a project. If OAuth is unavailable, Mudlark falls back to the URL scheme.

Sub-task hierarchy is preserved via the API. Tasks are created in the selected project (or the inbox if none is chosen).

Bulk export

Export all notes at once as a ZIP archive. Go to File › Export All Notes. Choose from Markdown, Rich Text, Plain Text, or Apple Notes format. Each note becomes a separate file in the archive, with filenames based on note titles (duplicates get a numeric suffix).

Copy to clipboard

Besides full export, you can copy note content to the clipboard in several ways:

  • Copy Rendered. Copies the formatted right-pane content
  • Copy Source. Copies the raw left-pane text

The default clipboard format (Markdown, Rich Text, Plain Text, or Apple Notes) is configurable in Settings.

Automating exports

Trigger exports programmatically with the mudlark://export URL scheme:

mudlark://export?title=Meeting&destination=obsidian

See the Automation guide for the full URL scheme reference.