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
- Add a destination in Settings › Export. Each destination has its own format, folder, and connection settings.
- Press
⌘E(or use the menu) to export the current note. If you have multiple destinations, Mudlark asks which one to use. - 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
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:
- In Craft, right-click the folder you want to export into
- Select “Copy Deeplink”
- 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:
- Open Craft and go to the Imagine tab (top-right)
- Click “Add API Connection”
- Set permission level to “Read & Write”
- Copy the Endpoint URL and API Key from the modal
- 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:
- In Mudlark’s export settings, click “Install Shortcut” to open the pre-built “Mudlark to Apple Notes” shortcut
- Add it to your Shortcuts library
- 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:
- Go to notion.so/profile/integrations and create a new internal integration
- Grant it “Insert Content” permission
- In Notion, open the page you want to export into, click the … menu, select Connections, and add your integration
- In Mudlark’s settings, paste the Integration Secret (starts with
ntn_) - Paste the Parent Page URL (the full Notion URL or just the page ID)
- 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.