Paperful Icon

Paperfuldocs

Core Concepts

Paper Graph

The structured, ordered representations of a paper's content.

The Paper Graph is how Paperful represents what's inside a paper. Instead of one large block of extracted text, a processed paper becomes an ordered sequence of nodes. Each node is a title, paragraph, table, image, formula or other element, and it remembers where it came from in the original document.

Title Paragraph Section Title Image Table ...

The graph is useful whenever you need more than plain text:

  • Search and RAG: go from a search hit to the exact part of a document, and the content around it.
  • Citations: link an answer back to a page and region of the original document.
  • Document viewers: show, highlight or style content based on what it is.
  • Extraction: pull out only the tables, headings or references.

If you only need a document's text, Markdown is simpler. Paperful generates Markdown from the graph, so both always describe the same content.

Why a graph

Flattening a document into text loses its structure:

2026 Annual Report
Revenue increased by 24%.
Regional Performance
North America
$12.4M
Europe
$8.7M

From the text alone, you can't tell which lines are headings, paragraphs or table cells. The graph keeps that information:

Document title2026 Annual Report TextRevenue increased by 24%. Section titleRegional Performance TableRegional revenue

Applications can then treat the paper as a document, not just a sequence of characters.

Reading order

Nodes are arranged in the order a person would read the document. Multi-column layouts, figures and footnotes are placed where they belong in that flow, rather than strictly top to bottom.

Reading order is separate from pages. A section that starts at the bottom of one page and continues on the next is still one continuous run of nodes, while each node still remembers which page it appeared on.

Page 1   1 → Document title
         2 → Text
         3 → Text
Page 2   4 → Section title
         5 → Text
         6 → Table

Reading order lets you move through a document naturally. Pages let you point back to the source.

Because nodes are ordered, you can start from any node and move to the ones before and after it. You can also ask for a node's context: the nodes immediately around it, in a single step.

This means you rarely need to load a whole paper. Load the part you care about, then expand outward only as far as you need.

From search to context

Search results point directly into the graph. Each result tells you which nodes matched and which pages they're on.

That makes a simple pattern for RAG and agents possible:

Question Search Matching nodes Surrounding nodes Model
  1. Search for content relevant to the question.
  2. Find the nodes that matched.
  3. Add the nodes around them for context.
  4. Give that focused, structured context to the model.

See Search to context for a working example.

Because every node keeps its page and position on the page, the model's answer can be traced back to the exact place in the original document.

On this page