Obsidian to PDF

How to export Obsidian notes as PDF — step by step (+ easier way)

Obsidian is a powerful markdown note-taking app with a thriving plugin ecosystem, but its PDF export is surprisingly basic. Here is how to get your notes into PDF format — using the built-in export, community plugins, and a simpler browser-based alternative.

Free — 3 PDFs per month. No credit card required.

Step by step

How to export Obsidian notes as PDF

Three approaches: built-in export, CSS snippets, and community plugins.

Method 1: Built-in export (simplest)

Obsidian has a native PDF export that uses the Chromium print engine under the hood.

  1. Open the note you want to export in Obsidian.
  2. Click the three-dot menu (More options) in the top-right corner of the note.
  3. Select "Export to PDF" from the dropdown.
  4. Configure the export settings:
    • Page size — A4, Letter, or Legal
    • Landscape — toggle for wide content like tables
    • Margin — Default, Minimal, or None
    • Downscale percent — reduce content size to fit more per page
  5. Click "Export to PDF" and choose a save location.

The output uses your current vault theme's CSS. If you use a dark theme, the PDF will have a dark background that wastes printer ink. Light themes generally produce better print output.

Method 2: Custom CSS snippets for better print output

You can create a CSS snippet to improve PDF output without installing plugins.

  1. Go to Settings > Appearance > CSS snippets in Obsidian.
  2. Open the snippets folder and create a new .css file (e.g., print-styles.css).
  3. Add print-specific CSS rules using @media print selectors. Common improvements include setting a white background, adjusting font sizes, hiding UI elements, and controlling page breaks.
  4. Enable the snippet in Settings, then export as normal.

This approach requires CSS knowledge and trial-and-error to get right. Each theme may need different overrides, and Obsidian updates can break custom CSS.

Method 3: Community plugins

The Obsidian community has created several PDF export plugins that improve on the built-in feature.

  • Better Export PDF — adds configurable headers/footers, page numbering, custom margins, and better CSS handling. The most popular PDF plugin with active maintenance.
  • Pandoc PDF Export — uses Pandoc (the universal document converter) to generate PDFs via LaTeX. Produces excellent academic-quality output but requires installing Pandoc and a LaTeX distribution (several hundred MB). Best for users who already have Pandoc in their workflow.
  • Webpage HTML Export — exports notes as standalone HTML files that can then be opened in a browser and printed as PDF. Adds an extra step but produces clean, self-contained output.

Community plugins require installation from Settings > Community plugins, and each has its own configuration. They may break when Obsidian updates — check plugin compatibility before updating.

Limitations

Common issues when exporting Obsidian notes as PDF

Obsidian is built for writing and linking, not for print output.

Basic Chromium print styling

The built-in export uses Chromium's print engine with your vault's theme CSS. There is limited control over typography, page breaks, or print-specific formatting. The output often looks like a screenshot of the editor, not a designed document.

Wiki-links do not resolve

Obsidian's signature feature — [[wiki-links]] — appear as plain text in exported PDFs. Internal links between notes do not become clickable links or references. The rich graph of connections that makes Obsidian valuable is lost in the export.

Embedded notes may not expand

Obsidian's note embedding syntax (![[note]]) may not expand in PDF export. Embedded content might show as a link or placeholder instead of the actual note content, depending on your theme and plugins.

Dark themes waste ink

If your vault uses a dark theme, the PDF inherits that dark background. This wastes enormous amounts of printer ink and looks odd on screen. You need to switch to a light theme before exporting, then switch back — a tedious workflow for regular exports.

Plugins may break between updates

Community plugins depend on Obsidian's internal APIs, which change between versions. A plugin that works perfectly today may break after an Obsidian update, leaving you without PDF export until the plugin author releases a fix.

The easier way

Export Obsidian notes as professional PDFs with Pretty PDF

For Obsidian Publish users, the simplest path to beautiful PDFs.

If you use Obsidian Publish to share your notes on the web, Pretty PDF works directly on your published pages — no plugins, no CSS snippets, no configuration. The published HTML is clean and well-structured, and Pretty PDF's extraction engine handles it perfectly.

For notes that are not published, you can export to HTML using the Webpage HTML Export community plugin, open the HTML file in Chrome, and use Pretty PDF from there. This adds one extra step but produces significantly better output than the built-in export.

1

Open your published note in Chrome

Navigate to your Obsidian Publish site (publish.obsidian.md/your-vault or your custom domain) and open the note you want to export.

2

Click the Pretty PDF extension icon

The extension extracts the note content — markdown-rendered headings, code blocks, tables, images, and callouts — while removing Obsidian Publish's navigation, sidebar, and graph view.

3

Choose a template and generate

The Academic template works particularly well for knowledge base content. Dark Mode is great for code-heavy notes. Click Generate PDF for a polished document.

Obsidian Export vs Pretty PDF

Feature Obsidian Export Pretty PDF
Setup required Plugin config or CSS snippets None — works on published pages
Templates Inherits vault theme 5 professional templates
Dark theme handling Dark background in PDF Clean light output (or Dark Mode template)
Code block formatting Theme-dependent Monospace fonts, proper wrapping
Clutter removal Exports full editor view Extracts content only

Frequently asked questions

Open the note, click the three-dot menu (More options), and select "Export to PDF." Choose page size and margins, then export. The output uses your current theme's CSS, which may not be optimized for print. For better results, use a light theme or install the Better Export PDF community plugin.
Obsidian's built-in PDF export does not resolve wiki-links ([[links]]) or backlinks. They appear as plain text in the PDF. Community plugins like Better Export PDF can resolve some links, but complete backlink context requires additional setup. The graph view is not included in any export.
Yes. If you publish your Obsidian vault via Obsidian Publish, you can use Pretty PDF on the published pages to generate PDFs with professional templates. This is the easiest path for well-formatted output — no plugins or CSS configuration needed.
Better Export PDF and Pandoc PDF Export are the most popular community plugins. Better Export PDF is easier to set up and adds headers, footers, and margins. Pandoc PDF Export produces academic-quality output but requires installing Pandoc and LaTeX. For the simplest option, publish notes via Obsidian Publish and use Pretty PDF.

Export notes as beautiful, professional PDFs

Free — 3 PDFs per month. No credit card required.

Install Free Extension