Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Document Exporter

rogerdigitalrogerdigital10k downloads

Export notes, folders, and query results into Markdown bundles, HTML documents, and print-ready exports.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates29

Export single notes, entire folders, or hand-picked files into PDF, Word, EPUB, Markdown bundles, and HTML documents. Supports batch export with directory structure preservation.

Document Exporter selected files to PDF

Features

  • Batch export — export an entire folder or selected files at once, preserving directory structure
  • Merged export — combine a folder or selected files into a single document in any format, with a table of contents where supported
  • Embed expansion — note embeds (![[Note]], ![[Note#Heading]]) are inlined into exports, with cycle detection and a depth limit
  • PDF — generates a print-ready .pdf with native Obsidian rendering
  • Word document — generates a .docx document for editing and sharing
  • EPUB e-book — generates a self-contained .epub with embedded images and a navigable table of contents (desktop and mobile)
  • Markdown bundle — batch export creates one .md file per source note plus a shared assets/ directory, with attachments copied and links rewritten
  • HTML document — batch export creates one standalone .html per source note, with table of contents, native rendering, and linked assets
  • Progress bar with cancel — visual progress indicator for every export, with a cancel button that preserves already-exported files

Usage

Multiple ways to start an export:

Entry point How
Sidebar icon Click the export icon in the left sidebar
Right-click a file File explorer → right-click a Markdown file → "Export this file"
Right-click a folder File explorer → right-click a folder → "Export this folder"
Right-click in editor Right-click inside a note → "Export current file"
Command palette Cmd/Ctrl+P → "Export documents"

Export dialog

  1. Choose source — current file, folder, or selected files
  2. Choose format — PDF, Word document, EPUB e-book, Markdown bundle, or HTML document. PDF is not offered on mobile.
  3. Set output folder — type a path, click Vault to pick from vault folders, or Choose folder to select a system folder (desktop only)
  4. Set file name (single file) or folder name (batch export) — defaults to the source file or folder name
  5. Optional (batch sources): enable Merge into a single file to render every source note into one document, and set its file name
  6. Click Next → review the summary → click Export

A progress bar appears during export showing the current step or file. Click Cancel to stop; already-exported files are kept.

Examples

Export the current note as PDF

  1. Open a note → right-click → Export current file
  2. Format: PDF → click Export
  3. Result: exports/<filename>.pdf

Export a folder as Markdown bundle

  1. Right-click a folder → Export this folder
  2. Format: Markdown bundle → click Export
  3. Result: exports/<foldername>/<filename>.md + assets/ (if images exist)

Export selected files as HTML

  1. Start an export from sidebar icon or command palette
  2. Source: Selected files → pick files → Format: HTML document
  3. Click Export
  4. Result: a standalone .html per file with linked assets

Merge a folder into one PDF

  1. Right-click a folder → Export this folder
  2. Format: PDF → enable Merge into a single file → set the file name
  3. Click Export
  4. Result: <output folder>/<file name>.pdf containing every note as a section, with a table of contents

Settings

Open Settings → Document Exporter. All settings are indexed and searchable from Obsidian's settings search (Obsidian 1.13+).

Setting Description Default
Default export format Format pre-selected when opening the dialog PDF
Output folder Vault-relative folder, or an absolute system path on desktop (~/ is supported) exports
Expand note embeds Inline ![[Note]] embeds into exported documents On
Include source path comments Add HTML comments showing each section's origin Off
Copy attachments Copy referenced images and files into the export On
Overwrite existing exports Replace existing export files when enabled. When disabled, empty destinations are reused. Existing output files or a shared assets directory cause the export to use a timestamped child folder inside the selected output folder (or a suffixed batch folder). Documents, attachments and reports stay together; previous exports are preserved. The confirmation page shows the resolved destination, which is rechecked when exporting. Off

Format capabilities

Native rendering (Obsidian's own engine) is used for desktop PDF and in-app HTML; DOCX and EPUB use format-specific basic conversion. Exact visual parity with Obsidian is not promised.

Format Rendering path Local images Non-image attachments Links Platforms Documented limitations
PDF Obsidian native print Copied to assets/ Copied to assets/ Rewritten relative Desktop only Requires the desktop app
Word (.docx) Format-specific converter Embedded in the document Copied to assets/ Internal headings, external URLs Desktop, mobile Basic conversion; no exact visual parity
EPUB Format-specific converter Packaged inside the .epub Not packaged Cross-note links omitted Desktop, mobile Images only
Markdown bundle Markdown passthrough Copied to assets/ Copied to assets/ Rewritten relative Desktop, mobile —
HTML Native in-app renderer (basic converter as fallback) Copied to assets/ Copied to assets/ Rewritten relative Desktop, mobile —

Word exports convert supported inline ($…$) and display ($$…$$) LaTeX to editable equations. EPUB and the basic HTML renderer emit MathML. Unsupported formulas in these converters are kept as source text and reported as export warnings.

Limitations

  • Block-reference embeds (![[Note#^block]]) are not expanded
  • EPUB embeds images only; other attachments and links between notes are omitted
  • In merged exports, links between merged notes become in-document anchors (markdown) or are omitted (EPUB); links to notes outside the export are unchanged
  • Dataview queries are not executed during export
  • Canvas files are not supported
  • PDF export requires the desktop app and is not offered on mobile

Privacy

All processing happens locally. The only network activity is fetching remote resources referenced by the note itself during export rendering (for example http(s) images); exported documents keep those references, so a browser or reader opening them may load the same resources. No telemetry is collected and no document content is sent to any external service.

Installation

Search "Document Exporter" in Settings → Community plugins → Browse and click Install.

Manual installation

Copy main.js, manifest.json, and styles.css into your vault's .obsidian/plugins/document-exporter/ directory.

Development

npm install
npm run dev      # watch mode
npm run build    # production build
npm test         # run tests

License

MIT

HealthExcellent
ReviewPassed
About
Export notes, folders, or query results as Markdown bundles, standalone HTML documents with a table of contents, or print-ready HTML optimized for browser-to-PDF. Combine selected notes into a single .md with copied attachments and rewritten links, generate self-contained .html with linked assets, or produce print-styled HTML ready for PDF export.
ExportAttachmentsPublishing
Details
Current version
1.1.2
Last updated
3 days ago
Created
7 months ago
Updates
29 releases
Downloads
10k
Compatible with
Obsidian 1.4.0+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
rogerdigitalrogerdigital
GitHubrogerdigital
  1. Community
  2. Plugins
  3. Export
  4. Document Exporter

Related plugins

Share Note

Instantly share/publish a note, with the full theme and content exactly like you see in Obsidian. Data is shared encrypted by default, and only you and the person you send it to have the key.

Wechat Converter

将 Markdown 转换为微信公众号排版,并支持一键发送到微信(weixin/wx)公众号(支持自定义 CSS和公众号贴图)、飞书、小红书(rednote)、知乎、微博、CSDN等20+平台。

GitHub

Share as Gist

Share a note as a GitHub.com Gist.

MP Publisher

Preview with custom CSS themes and publish articles to WeChat Official Accounts with one click.

Publish to Telegram

Allows you to post notes directly to Telegram channels, groups and personal messages with different presets and advanced publishing settings.

TTRPG Tools - Publish

Generates publish.js/publish.css and a publish-assets manifest for TTRPG Tools: Maps (Zoom Map).

Custom Attachment Location

Customize attachment location with variables($filename, $data, etc) like Typora.

Consistent Attachments and Links

Move note attachments and update links automatically.

YAOS

Simple real-time sync powered by your own Cloudflare Worker.

Ink

Handwriting and drawing directly between paragraphs using a digital pen, stylus, or Apple pencil.