A powerful document export plugin for Obsidian that leverages Pandoc to convert your notes to various formats.
Export your Obsidian notes to:
- Word Documents (.docx)
- PDF files (.pdf)
- ePub books (.epub)
- HTML websites (.html)
- PowerPoint presentations (.pptx)
- LaTeX documents (.tex)
- And many more formats
- Universal YAML CLI Control: Control any Pandoc argument via frontmatter
- Smart Path Resolution: Automatically finds templates and files across your vault
- Per-Document Configuration: Fine-grained control without global settings
- Space-Safe File Paths: Handles file names with spaces automatically
- Theme-Compatible: Works seamlessly with light and dark Obsidian themes
This lets you write presentations, draft books, make webpages, and write assignments all in Markdown, with professional-grade formatting control, all without leaving Obsidian.
Note: This plugin is desktop-only and requires Pandoc to be installed on your system.
- Open Obsidian Settings
- Go to Community Plugins and disable Safe Mode
- Click Browse and search for "Pandoc Plugin"
- Install and enable the plugin
- Download the latest release from the releases page
- Extract the files to
{VaultFolder}/.obsidian/plugins/obsidian-pandoc/ - Reload Obsidian and enable the plugin in Settings
Prerequisites: Install Pandoc on your system first.
For detailed installation instructions, see the Installation Wiki.
- Open the command palette (
Ctrl+P/Cmd+P) - Search for "Pandoc"
- Choose your desired export format
- The exported file will be saved in the same folder as your note
If you export a file called MyNote.md as a Word Document, you'll find MyNote.docx in the same folder.
Control Pandoc's behavior on a per-document basis using YAML frontmatter:
---
# Standard metadatatitle: "My Academic Paper"author: "John Doe"date: "2024-01-01"# Pandoc CLI arguments with pandoc- prefixpandoc-number-sections: truepandoc-toc: truepandoc-toc-depth: 3pandoc-template: "academic-paper.tex"pandoc-bibliography: "references.bib"pandoc-csl: "apa.csl"pandoc-css: "custom-styles.css"
---
# Your document content here...Smart Path Resolution: Templates and files are automatically found in:
- Same folder as your note
- Vault root directory
- Common template folders (
templates/,pandoc/,assets/, etc.)
Universal Support: Any Pandoc CLI argument works with the pandoc- prefix - boolean flags, file paths, options, and arrays.
# Clone the repository
git clone https://github.com/your-username/obsidian-pandoc.git
cd obsidian-pandoc
# Install dependencies
npm install
# Start development build
npm run dev# Build for production (includes TypeScript type checking)
npm run build
# Version management (bump version across manifest.json and versions.json)
npm run version
# Run linting
npm run lint
# Auto-fix linting issues
npm run lint:fixSee development.md for detailed development instructions.
Contributions are welcome! Please feel free to submit issues and pull requests.
This project is licensed under the MIT License - see the LICENSE.md file for details.
This plugin is a maintained fork of the original obsidian-pandoc by Oliver Balfour. The original work has been completely modernized and significantly enhanced with advanced features.
Original Author: Oliver Balfour
Original Repository: https://github.com/OliverBalfour/obsidian-pandoc
This fork includes comprehensive modernization and advanced features:
- ✅ Full Template Compliance: Exceeds official Obsidian plugin template standards
- 🚀 Universal YAML CLI Control: Per-document Pandoc configuration via frontmatter
- 🚀 Smart Path Resolution: Vault-wide template and file discovery
- 🔧 Modern Tooling: TypeScript type checking, automated version management, ESLint v9
- 🎨 Theme Integration: Dark/light theme compatible styling
This plugin is in beta. While it works well for most use cases, there may be minor formatting issues. Always proof-read your exported documents!