Connect to Obsidian

The Unmarkdown plugin for Obsidian lets you right-click any note and copy it formatted for Google Docs, Word, Slack, OneNote, Email, or Plain Text. You can also publish notes to the web with 62 templates, all without leaving your vault.

1. Open Obsidian and go to Settings
2. Select Community Plugins
3. Click Browse and search for Unmarkdown
4. Click Install, then Enable

A free Unmarkdown account is required. The plugin uses OAuth to connect securely without requiring you to manage API keys.

1. In Obsidian: Settings > Unmarkdown
2. Click Connect account
3. Your browser opens to unmarkdown.com. Log in or create an account, then click Allow
4. You are redirected back to Obsidian. Done.

Right-click any .md file in the file explorer or right-click inside the editor to see the Copy with Unmarkdown submenu with 6 destinations:

• Google Docs (preserves headings, tables, code blocks, lists)
• Microsoft Word (compatible formatting)
• Slack (mrkdwn format)
• OneNote (section-aware formatting)
• Email (inline CSS for Gmail, Outlook, Apple Mail)
• Plain Text (clean, readable output)

You can also use the command palette (Cmd+P / Ctrl+P) and search for “Unmarkdown” to find all copy commands. If text is selected in the editor, only the selection is converted.

Publish any note as a beautifully formatted web page:

1. Open the command palette and run Unmarkdown: Publish this note
2. Choose a template, set the URL slug, and click Publish
3. The published URL is copied to your clipboard

Published notes are linked via frontmatter fields (unmarkdown_id and unmarkdown_url). To update a published note after editing, run Unmarkdown: Update published note.

Published notes panel

Open the sidebar panel with Unmarkdown: Open published notes panel to see all published and draft notes in your vault. Click a note to open it, click a URL to view the published page, or use the Update/Unpublish buttons.

Go to Settings > Unmarkdown to configure:

• Default destination (used by the ribbon icon and default copy command)
• Default template for published notes
• Default visibility (anyone with link or public)
• Ribbon icon visibility
• Status bar visibility (desktop only)
• Notification level (always, errors only, or never)

Free accounts include 1,000 API calls per month, 5 documents, and 8 templates. Upgrade to Pro for:

• All 62 templates in the publish modal
• Batch publish (right-click a folder to publish all notes)
• Custom URL slugs
• Hide the Unmarkdown badge on published pages
• 10,000 API calls per month
• Unlimited documents

The plugin automatically handles Obsidian-specific markdown before sending to the API:

• [[wikilinks]] are converted to plain text
• ![[embeds]] are removed
• %%comments%% are stripped
• > [!callout] blocks are converted to standard blockquotes
• YAML frontmatter is stripped from the converted output

“Connect your Unmarkdown account first”

Go to Settings > Unmarkdown and click “Connect account” to start the OAuth flow.

“Session expired”

Your access token has expired and could not be refreshed. Go to Settings > Unmarkdown, disconnect, and reconnect your account.

“Could not connect to Unmarkdown”

Check your internet connection. The plugin requires network access to call the Unmarkdown API.

Plugin not appearing after install

Make sure you have enabled the plugin in Settings > Community Plugins. You may need to restart Obsidian.