Welcome to the Obsidian PDF to Markdown Converter! This extension brings the power of advanced PDF conversion directly into your Obsidian vault. By leveraging the capabilities of the Marker API, this plugin offers a seamless way to transform your PDFs into rich, formatted Markdown files.
Important
This extension requires a Marker API endpoint to function. Without an endpoint, the application won't work.
You can find the related repositories here:
- Marker Project (AI model for PDF conversion)
- Marker API (API for self-hosting the conversion service)
- OCR Capabilities: Convert scanned PDFs to searchable text
- Formula Detection: Accurately captures and converts mathematical formulas
- Table Extraction: Preserves table structures in your Markdown output
- Image Handling: Extracts and saves images from your PDFs
- Mobile Compatibility: Works on both desktop and mobile Obsidian apps
- Flexible Output: Choose between full content extraction or specific elements (text/images)
- Superior Extraction: Utilizes the Marker project's advanced AI model for high-quality conversions
- Mobile Accessibility: Unlike many converters, this works seamlessly on mobile devices
- Customizable: Tailor the conversion process to your specific needs
- Obsidian Integration: Converts PDFs directly within your Obsidian environment
If you enjoy this extension, feel free to star the repository and share it with others! When you want to support the development, consider buying me a coffee:
To use this extension, you'll need:
- An Obsidian vault
- Access to a Marker API endpoint (self-hosted or paid service)
-
Install the extension in your Obsidian vault
-
Configure your Marker API endpoint in the plugin settings
-
(Optional) Set up a self-hosted Marker API:
- Use Docker on a machine with a solid GPU/CPU
- (Optional) Make the endpoint available to other devices (e.g., using Tailscale)
- Alternatively, host in the cloud or run the Python server as needed
| Setting | Default | Description |
|---|---|---|
markerEndpoint |
'localhost:8000' |
The URL of your Marker API endpoint |
createFolder |
true |
Bundle all output files in a folder |
movePDFtoFolder |
false |
Move the original PDF to the output folder |
createAssetSubfolder |
true |
Create a subfolder for extracted assets (images, etc.) |
extractContent |
'all' |
Options: 'Extract everything', 'Text Only', 'Images Only' |
writeMetadata |
true |
Include metadata in the converted Markdown file |
deleteOriginal |
false |
Delete the original PDF after conversion |
This extension wouldn't be possible without the incredible work of:
- Marker Project: The AI model powering the conversions
- Marker API: The API that enables self-hosting of the conversion service
A huge thank you to these projects for their contributions to the community!
If you encounter issues related to the extension itself, please open an issue in this repository. For problems with the conversion process or API, please refer to the Marker and Marker API repositories.
Contributions, issues, and feature requests are welcome! Feel free to check the issues page.
Happy converting! 📚➡️📝
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent