BlogOpen tool

Vault-ready notes

PDF to Markdown for Obsidian

Updated · pdftomd.tools team

This Obsidian PDF to Markdown workflow turns a paper, a manual, or a handout into a plain-text note with real headings, lists, and tables, ready for your vault.

Convert a file
Document card turning into a note inside a dark note-taking app

Drop a text-based file below. The PDF to Markdown result appears on the right; copy it into a new note or download the .md file and move it into your vault folder.

Runs in your browser · nothing uploaded

Source PDF

Drop a PDF here, or click to browse

Text PDFs only. Scans need OCR, which this tool does not run.

Markdown preview

Markdown output will appear here.
Workflow

Obsidian PDF to Markdown in four steps

Each PDF to Markdown step runs on your own device and takes a few seconds.

  1. File dropped onto an upload area
    01

    Drop the source

    Choose a text-based file rather than a scan. PDF to Markdown needs a real text layer to read words, sizes, and positions.

    Choose a file
  2. Text runs grouped into ordered lines
    02

    Let the structure appear

    Large type becomes headings, bullet markers become lists, and aligned columns become tables. The PDF to Markdown output joins all pages into one note.

    See it run
  3. Markdown preview with headings and lists
    03

    Add frontmatter

    Paste the template from this page above the PDF to Markdown text, then fill in the title, source, and tags.

    Copy the template
  4. Markdown and document icons with arrows
    04

    Save into the vault

    Download the .md file into your vault folder, or paste the PDF to Markdown text into a new note. Obsidian picks it up straight away.

    Save the note
Why it helps

Why convert instead of attaching the file

Once you convert PDF to Markdown, the text becomes an ordinary note: every heading can be linked with [[Note#Heading]], backlinks show where an idea is reused, and graph view connects the source to the notes you write about it. A PDF attached to a vault stays a closed box: you cannot link to one of its sections, and your highlights stay inside the viewer.

Plain files also last. An Obsidian PDF to Markdown note is just text on disk, so it syncs with any service, diffs cleanly in git, and stays readable if you ever leave the app. Keep the original in an attachments folder and point to it from the frontmatter, so each PDF to Markdown note and its source stay paired.

  • Headings in the PDF to Markdown output work as link targets
  • Lists and tables stay editable as plain text
  • Paragraphs stay whole across page breaks

Limits of PDF to Markdown to know first

Scans have no text layer and the tool does not run OCR, so image-only files come out empty. Merged table cells are flattened, rotated tables are not detected, borderless tables need at least three rows, and the first row always becomes the header. Embedded images are not exported, and two-column layouts can interleave. Wiki links and tags are not created for you; add them after the PDF to Markdown pass.

Page → NoteExample
Printed page beside a Markdown note that starts with frontmatter
A printed page on the left; the Obsidian PDF to Markdown note, with frontmatter and a heading, on the right.
Template

Frontmatter for PDF to Markdown notes

Copy this block, paste it at the very top of the note, and edit the values.

Note frontmatter

Obsidian shows these fields as properties. Keep the source field so every Obsidian PDF to Markdown note points back to its original file.

---
title: Your note title
source: "[[original.pdf]]"
author:
year:
tags:
  - source/pdf
  - to-read
created: YYYY-MM-DD
---
Use cases

Obsidian PDF to Markdown in real vaults

Three common ways people bring PDF to Markdown notes into a vault.

Stack of papers turning into linked notes in a graph

Literature notes

Convert each paper with this Obsidian PDF to Markdown flow, keep its section headings, and link your reading notes to the exact heading you are discussing.

Convert a paper
Vault folder tree with Markdown notes in subfolders

Manuals and handbooks

Split a long PDF to Markdown file at its ## headings into several notes, file them in folders, and link them from one index note.

Convert many files
Highlighted note beside a checklist and a calendar

Study and review

Turn lecture handouts into PDF to Markdown notes, highlight key lines with ==marks==, and add checklists for review.

Convert a handout
Local-first
Local in-browser processing illustration

Private Obsidian PDF to Markdown conversion

PDF to Markdown conversion runs in your browser with pdf.js, and the file never reaches our servers. That suits a local-first vault: the text goes from your file to your note without passing through anyone else's computer.

Runs in your browserNo server uploadWorks with local vaults
Read the privacy policy
Other direction
Two-way arrow between Markdown and document icons

Print a note as a document

When a note built from PDF to Markdown text is ready to share, the reverse page renders it as A4 pages, again entirely in the browser.

Markdown to PDF
Tool suite

Related tools

Other pages that help with PDF to Markdown work.

Home converterThe main tool with an overview and sample output.Online converterHow headings, lists, and tables are detected.Private conversionA privacy-first walkthrough of the same job.Batch conversionProcess several files and download one ZIP.Python guideScript extraction locally with open-source libraries.LLM inputPrepare clean context for chat and retrieval.Print exportRender notes as clean A4 pages.Notes guideTurn one PDF into linked, editable notes.

Start your Obsidian PDF to Markdown import

Drop a file, add the frontmatter, and save a clean PDF to Markdown note into your vault. Free, private, and nothing to install.

Convert a file

Sources

  1. Internal links — Obsidian Help
  2. GitHub Flavored Markdown Spec — GitHub
  3. pdf.js — Mozilla
Questions

FAQ

Questions about Obsidian PDF to Markdown notes, vaults, and limits.

How do I get a PDF into Obsidian as Markdown?

Drop the file into the converter above, then copy the PDF to Markdown result into a new note or download the .md file into your vault folder.

Is this an Obsidian plugin?

No. It is a web page, so there is nothing to install. The Obsidian PDF to Markdown output is a plain .md file that any vault can open.

Are tables kept in PDF to Markdown notes?

Yes, for most text-based tables: they become GFM pipe tables that Obsidian renders; in our tests all 12 table fixtures passed. Merged cells are flattened and rotated tables come through as plain lines.

Does Obsidian PDF to Markdown work on scans?

No. Scans have no text layer and the tool does not run OCR, so the tool warns you when a file looks image-based.

Are images from the PDF exported?

No. PDF to Markdown output is text only. Keep the original in your attachments folder and embed it with ![[file.pdf]] when you need the figures.

Will links and tags be added for me?

No. Add [[wiki links]] and tags yourself after conversion, or list tags in the frontmatter template above.

Is my file uploaded during PDF to Markdown conversion?

No. Processing happens in your browser and the file never leaves your device.