Obsidian - Linking to PDFs

Linking directly to specific pages inside PDF files is the key payoff: Obsidian can render a PDF preview inside a note and jump straight to a chosen page (e.g., page 5), turning rules and adventure handouts into navigable, campaign-ready references. That matters for tabletop RPG prep because it reduces the need to manually transcribe long modules into separate notes—especially when publishers provide well-formatted PDFs.

The workflow starts with getting PDFs into the Vault. PDFs can be dragged into Obsidian; when they’re added as attachments, they land in the Vault’s configured attachments folder (set via “Set as attachment folder” on a folder). Once the files are present, Obsidian can display them with built-in PDF viewing features such as page-by-page browsing, chapter mode navigation, zoom controls, page count, and options like rotate, download/print, and toggling annotations. To make sure file types show up correctly, the video recommends enabling “detect all file extensions” under Settings → Files and links.

The practical “cool” part is how Obsidian links to PDFs with embedded rendering. Instead of linking to a PDF as a generic file, the note can include a link that renders the PDF content inline. The example uses a syntax that both targets a particular PDF and specifies a page number, so the rendered view opens at the requested page rather than forcing readers to scroll from page one. In read mode, the preview loads and skips to the defined page; the presenter notes that the PDF render syntax uses code-like markers (including an exclamation mark) that should be removed when using the snippet as normal text.

This approach also supports contextual navigation inside an adventure. By creating links from wherever a player-facing note or prep note lives, the campaign can jump to the relevant section of the module—such as “this chapter corresponds to that page in the PDF.” The video demonstrates that the hover preview may be small, but clicking still takes you to the rendered PDF view at the correct page.

For organizing multiple PDFs, the video adds a second layer: DataView JS queries that automatically list PDFs in the Vault. One query scans all files where the extension equals PDF and produces a list of their file paths, effectively generating a live catalog. A variation filters to a specific folder (e.g., a folder like “Z_underscore assets”), so a landing page can show only the PDFs stored there. As new PDFs are added, the list updates automatically.

Overall, the method leans on out-of-the-box PDF support for viewing and linking, with optional plugins only for annotation/highlighting enhancements. The result is a faster prep pipeline: keep adventures and rules in their original PDF form, link to exact pages from Obsidian notes, and use DataView JS to maintain an always-current index of available documents.