PDF to Drupal: Rebuilding Documents as Paragraphs and Layout Builder Sections
Drupal runs a large share of state agency and university sites, and those sites carry just as many buried PDFs. Here is how to rebuild a document as native Drupal content that Search API can actually index.
Converting a PDF on Drupal follows the same principle as anywhere else: rebuild the content as a page, keep the file as a download. What changes is the target. Instead of Gutenberg blocks, you produce Paragraphs, Layout Builder sections, or CKEditor 5 HTML. This walkthrough uses PDF to Drupal Page.
1Step 1: Choose the Output Model
Drupal gives you three good targets. Pick based on how the page will be maintained:
Paragraphs
Structured content types for pages your team will edit field by field. The most maintainable option for most documents.
Layout Builder
For multi-column source pages that need real layout regions rebuilt as sections.
CKEditor 5 HTML
Filtered semantic HTML in the body field, when you want the content in one rich-text field.
Not sure which? We compare them in Layout Builder vs. Paragraphs for a converted PDF.
2Step 2: Map Structure to Drupal Entities
| In the PDF | Becomes |
|---|---|
| Document title | Heading Paragraph (h1) |
| Section headings | Heading Paragraph (h2 to h4) |
| Body text and lists | Text Paragraph |
| Tables | Table Paragraph with scope |
| Images and charts | Media (image) with alt |
| Multi-column pages | Layout Builder section |
| The original file | Media (file) download |
3Step 3: Review Alt Text and Reading Order
The converter flags every image for alt text and confirms the reading order across columns before anything saves. This is where the composable model helps: each Paragraph is a discrete, reviewable unit, so approving a converted document feels like approving a stack of components rather than proofreading a wall of HTML.
4Step 4: Publish the Node, Keep the File, Feed Search API
The converter creates a draft node with a clean path alias and attaches the original PDF as a Media entity. Because the content is now node text rather than a binary file, Search API indexes it, so a resident searching your site actually finds it. Add a redirect from the old file path to the new node with the Redirect module.
5Step 5: Stop the Backlog With a Module
Conversion fixes the documents people read. To keep new PDFs from piling up untagged, pair it with the PDF Accessibility Remediator module, which scans every File and Media entity and can gate publishing until a document passes. Your Media library is often the biggest hidden liability on a Drupal site, as we cover in this breakdown.
Send us your worst PDF, on Drupal
We will convert it and send back the Paragraphs and the CKEditor 5 HTML so you can compare. No CMS migration required.
See PDF to Drupal Page