paper-to-obsidian

Convert PDF academic papers into Obsidian notes with Python scripts.

Updated May 27, 2026
One-click install
npx skills add https://github.com/RuifengFu/agent-skills --skill paper-to-obsidian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-to-obsidian
Source: https://github.com/RuifengFu/agent-skills/tree/main/opencode/paper-to-obsidian
Command: npx skills add https://github.com/RuifengFu/agent-skills --skill paper-to-obsidian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fitz, pdftotext, python3, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill converts academic papers from PDF format into well-structured notes in the Obsidian knowledge base, facilitating efficient reading and referencing.

Core Features & Use Cases

  • PDF to Notes Conversion: Extracts full text, figures, and metadata from PDF papers.
  • Structured Notes: Outputs notes in a specific template for easy referencing and searchability.
  • Use Case: Ideal for researchers or students who need to quickly convert papers into a usable format for their digital library.

Quick Start

Convert the paper titled 'Deep Learning' into an Obsidian note using the 'paper-to-obsidian' skill.

Frequently Asked Questions about paper-to-obsidian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert academic PDF papers into structured Obsidian notes?

You convert academic PDF papers into structured Obsidian notes by extracting full text, figures, and metadata to generate formatted markdown with structured frontmatter. This process requires Python libraries like fitz and pdftotext to parse the PDF and output the structured notes.

Can I extract figures and LaTeX math when converting PDF to Obsidian?

Yes, you can extract figures and render LaTeX math when converting PDF to Obsidian. The conversion process specifically handles figure extraction and LaTeX math rendering alongside text extraction to ensure academic notes retain their original mathematical formatting.

Do I need Python and specific libraries to extract text from PDF for Obsidian?

Yes, you need Python and specific libraries to extract text from PDF for Obsidian. The conversion process requires a Python 3 environment with the fitz and pdftotext libraries installed to properly parse the PDF files and generate the structured notes.

What is the best way to generate structured frontmatter for academic notes?

The best way to generate structured frontmatter for academic notes is using an automated PDF conversion script. It extracts metadata directly from the academic paper and formats it into Obsidian frontmatter, ensuring your digital library notes are consistently structured and searchable.

Does this PDF to Obsidian conversion process handle complex academic paper layouts?

The PDF to Obsidian conversion process handles academic paper layouts by extracting full text and figures while rendering LaTeX math. It is designed to parse standard academic PDF formats, though highly irregular layouts may require manual adjustments.

Why use fitz and pdftotext for PDF text extraction in Obsidian note generation?

You use fitz and pdftotext for PDF text extraction in Obsidian note generation because they reliably parse academic paper content. These Python libraries work together to extract the full text and figures needed to create well-structured Obsidian formatted notes.