README file from
GithubBeautiful PDF
Export Obsidian Markdown notes to styled PDFs. Map headings, body text, tables, callouts, and more to fonts and spacing in the settings UI, save named profiles, and preview the real PDF before saving.
Desktop only (uses Electron printToPDF).
Features
- Element styles — Configure headings (
#–######), body, quotes, lists, tasks, code, tables, callouts, images, links, footnotes, and embeds - Page setup — Paper size, margins, line height (%), page numbers, header/footer alignment, filename as title
- Profiles — Named style sets (e.g. Report / Everyday / Proposal) you can switch between
- Box presets — Accent bar, outline card, or soft fill for quotes, callouts, and note embeds
- True PDF preview — Same
printToPDFpipeline as export (page breaks match the saved file) - Page breaks — Insert
%%pdf-pagebreak%%or run Beautiful PDF: Insert page break
Recent updates
- System fonts — Choose fonts installed on your computer from Settings (Font → Choose…). Local fonts (including Korean typefaces) can be used directly in the PDF.
- Numbered lists as headings — Under Extras, style normal numbered lists (
1. 2. 3.) like headings in the PDF only. Obsidian keeps auto-numbering in the note;#headings and body text stay unchanged. Map top / nested / deeper levels to H1–H6 styles.
Commands
| Command | Description |
|---|---|
| Beautiful PDF: Preview current note as PDF | Open a modal with a real PDF preview |
| Beautiful PDF: Export current note to PDF | Export using the active profile |
| Beautiful PDF: Export current note with profile… | Pick a profile, then export |
| Beautiful PDF: Insert page break | Insert a page-break marker at the cursor |
Installation
Community plugins (after approval)
Search for Beautiful PDF in Obsidian Settings → Community plugins.
Manual installation
- Download
main.js,manifest.json, andstyles.cssfrom the latest release. - Create a folder named
beautiful-pdfinside your vault's.obsidian/plugins/directory. - Place the downloaded files in that folder.
- Enable the plugin in Obsidian settings (desktop).
BRAT (beta)
- Install the BRAT plugin.
- Add beta plugin:
https://github.com/Creative781/beautiful_pdf
Usage
- Open Settings → Beautiful PDF.
- Pick a profile (or create one) and adjust page / Markdown element styles.
- Open a note, then run Preview or Export from the command palette.
Korean system fonts (for example KoPubWorldDotum) must be installed on the computer to appear in the PDF.
Develop
npm install
npm run build
Copy or symlink this folder to .obsidian/plugins/beautiful-pdf/ (needs manifest.json, main.js, styles.css).
License
MIT
Connect
- YouTube: Creative781
- Blog: Creative781 Blog
Support
- Buy me a coffee: Support the developer