MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Create and edit PDFs: text, Markdown, tables, metadata and pages, with Japanese font embedding.
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
A privacy-first app that strips AI watermarks from content you own.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 28/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 40/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: 202 (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala PDF Writer (PDF Agent Stack). Sigue https://mcp.popnx.com/i/shuji-bonji-pdf-writer-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server PDF Writer (PDF Agent Stack) para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "pdf-writer": { "command": "npx", "args": [ "-y", "@shuji-bonji/pdf-writer-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de PDF Writer (PDF Agent Stack) aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
SettingsDeveloperEdit Config
{
"mcpServers": {
"pdf-writer": {
"command": "npx",
"args": [
"-y",
"@shuji-bonji/pdf-writer-mcp"
]
}
}
}Usa PDF Writer (PDF Agent Stack) y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando PDF Writer (PDF Agent Stack) o muestra una herramienta de PDF Writer (PDF Agent Stack) en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar PDF Writer (PDF Agent Stack)
PDF Writer (PDF Agent Stack) se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar PDF Writer (PDF Agent Stack)
Funciona con Claude Code, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server PDF Writer (PDF Agent Stack) para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user pdf-writer -- npx -y @shuji-bonji/pdf-writer-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de PDF Writer (PDF Agent Stack) aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user pdf-writer -- npx -y @shuji-bonji/pdf-writer-mcpDeberías ver PDF Writer (PDF Agent Stack) en la lista como conectado
Usa PDF Writer (PDF Agent Stack) y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando PDF Writer (PDF Agent Stack) o muestra una herramienta de PDF Writer (PDF Agent Stack) en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server PDF Writer (PDF Agent Stack) para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "pdf-writer": { "command": "npx", "args": [ "-y", "@shuji-bonji/pdf-writer-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de PDF Writer (PDF Agent Stack) aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Usa PDF Writer (PDF Agent Stack) y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando PDF Writer (PDF Agent Stack) o muestra una herramienta de PDF Writer (PDF Agent Stack) en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server PDF Writer (PDF Agent Stack) para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "pdf-writer": { "type": "stdio", "command": "npx", "args": [ "-y", "@shuji-bonji/pdf-writer-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de PDF Writer (PDF Agent Stack) aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Usa PDF Writer (PDF Agent Stack) y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando PDF Writer (PDF Agent Stack) o muestra una herramienta de PDF Writer (PDF Agent Stack) en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user pdf-writer -- npx -y @shuji-bonji/pdf-writer-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"pdf-writer": {
"command": "npx",
"args": [
"-y",
"@shuji-bonji/pdf-writer-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"pdf-writer": {
"command": "npx",
"args": [
"-y",
"@shuji-bonji/pdf-writer-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"pdf-writer": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@shuji-bonji/pdf-writer-mcp"
]
}
}
}Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
npm: @shuji-bonji/pdf-writer-mcpSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub shuji-bonji, dueña del repo
Último cambio de código: hace 9 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para @shuji-bonji/pdf-writer-mcp@0.28.1
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/shuji-bonji-pdf-writer-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 9 días, y la última versión (0.28.1) llegó al registro hace 9 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| Este PDF Writer (PDF Agent Stack) | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Se instala en tu equipo |
| Necesita clave | No | No | No | Sí | No | No |
| Se añade con + en Claude | No | No | No | No | Sí | No |
| Revisiones básicas | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| Licencia | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
MCP server that creates PDFs from text, Markdown, or tabular data and edits existing ones (metadata and page operations). Built on normativepdf — a clause-driven PDF library in which every behaviour is tied to an ISO 32000 clause — with CJK font embedding via harfbuzz subsetting.
Part of the PDF family alongside pdf-reader-mcp (structure analysis) and pdf-verify-mcp (authenticity verification). Where pdf-reader-mcp tells you *what is in* a PDF and pdf-verify-mcp tells you *whether it is genuine*, pdf-writer-mcp is the one that *writes it*.
[!IMPORTANT]
All file paths must be absolute (since v0.7.0). Relative paths and paths containing
..are rejected — a relative path would resolve against the MCP host's working directory, which is not the directory you think it is. This applies toinputPath,inputPaths,outputPath,outputDir,fontPathandattachmentPath. Input PDFs larger than 100 MB are also rejected.
| Tool | Purpose |
|---|---|
create_text_pdf | Plain text — honours \n, blank lines separate paragraphs, long lines wrap |
create_markdown_pdf | Markdown — headings, paragraphs, bullet/ordered lists, code blocks, quotes, rules, tables |
create_table_pdf | Ruled tables — automatic column widths, cell wrapping, headers repeated across page breaks |
Shared options: outputPath, returnBase64, fontPath, fontSize, pageSize (A4/A3/A5/LETTER/LEGAL), margin, title, drawTitle, author, onMissingGlyph, tagged, lang, pdfVersion.
Pass pdfVersion: "2.0" to write an ISO 32000-2 file. The default stays "1.7", and its bytes are unchanged.
The version is not only a header. ISO 32000-2 attaches two obligations to it, and both are met:
SOURCE_DATE_EPOCH.CreationDate and ModDate (§14.3.3); the title, author and producer move to the XMP metadata stream, where PDF 2.0 says document metadata belongs.{ "text": "Body.", "title": "Report", "pdfVersion": "2.0" }
With tagged: true, a 2.0 file declares PDF/UA-2 (ISO 14289-2) instead of PDF/UA-1, which allows only PDF 1.0 to 1.7 (ISO 14289-1 §6.1). See PDF/UA-2 below. Up to v0.26.x the combination was refused.
Pass tagged: true to produce an accessible, tagged PDF conforming to PDF/UA-1 (ISO 14289). Output is verified compliant by veraPDF (--flavour ua1, 106/106 rules).
{ "markdown": "# Title\n\nBody.", "title": "Report", "tagged": true, "lang": "en" }
Markdown maps onto the structure tree: headings → H1–H6, lists → L/LI/LBody, tables → Table/TR/TH/TD (headers get /Scope), quotes → BlockQuote, code → Code. Rules, borders and code backgrounds become artifacts. Under PDF/UA-1, heading levels are normalised so they start at H1 and never skip — a Markdown # → ### jump becomes H1 → H2 in the structure, while visual sizes stay as authored (PDF/UA-2 keeps the level as written; see below).
PDF/UA mandates a document title, so tagged: true requires title. The title is always written to the metadata (dc:title) and, by default, also drawn as the first H1. When the Markdown already starts with its own # … heading, pass drawTitle: false: the title then stays in the metadata only, and the first body heading becomes H1 (## → ### becomes H1 → H2). Output stays PDF/UA-1 compliant (veraPDF 106/106). lang (BCP 47) is inferred from the text when omitted and reported via warnings — pass it explicitly when you know it, since a wrong /Lang makes screen readers mispronounce the text.
[!NOTE]
Tagging is opt-in — default output is unchanged.
Machine validation (veraPDF) only sees whether things *exist*. It cannot judge whether reading order or alt text are *appropriate* — human review still matters.
Add pdfVersion: "2.0" to tagged: true and the file is written as PDF/UA-2 (ISO 14289-2:2024) on PDF 2.0. The default (1.7, PDF/UA-1) is unchanged.
{ "markdown": "# Title\n\nBody.", "title": "Report", "tagged": true, "pdfVersion": "2.0", "lang": "en" }
What differs from the PDF/UA-1 output, with the clause behind each:
| PDF/UA-1 (1.7) | PDF/UA-2 (2.0) | |
|---|---|---|
| XMP declaration (§5) | pdfuaid:part 1 | pdfuaid:part 2 and pdfuaid:rev 2024 |
| Namespaces (§8.2.4, §8.2.5.2) | none (the default PDF 1.7 namespace) | Document and every type the PDF 2.0 namespace has get /NS → http://iso.org/pdf2/ssn; BlockQuote and Code, which it lacks, stay in the PDF 1.7 namespace |
| Drawn title (§8.2.5.13) | first H1 | Title (not a heading) |
| Markdown headings (§8.2.5.12) | normalised to start at H1 and never skip | the level as written (# → H1, ### → H3) |
| Nested lists | inside the parent item's LBody | directly in the parent L, right after the item (ISO 32000-2 §14.8.4.8.2) |
Measured with veraPDF 1.30.0 (pdfua-2, 1,728 rules): the output of all three create tools, ensure_tagged on an untagged PDF 2.0 file, and ensure_pdfa(flavour: "pdfa-4") on a PDF/UA-2 file all pass, and the last one also passes PDF/A-4 (109/109).
Edits keep the declaration: when a tool rebuilds the XMP, pdfuaid:rev is carried with pdfuaid:part, and dc:title is kept when the Info dictionary has no Title (PDF 2.0 output does not put one there). add_bookmarks writes structure destinations on a PDF/UA-2 file, as §8.8 requires: a GoTo action whose SD names the structure element that starts on the target page, with D kept as the page destination for viewers that do not read SD. A page with no structure content keeps a page destination and is named in warnings.
An edit writes the PDF version of its input. Only an explicit conversion changes it: ensure_pdfa with flavour: "pdfa-4" / "pdfa-4f" (to PDF 2.0), and merge_pdfs with pdfVersion. Versions are never lowered.
INVALID_ARGUMENT. The message names the input's version and declarations; next_actions gives a call that fits. Examples: merge_pdfs over PDF 2.0 and PDF 1.x inputs without pdfVersion, and ensure_pdfa(flavour: "pdfa-3b") on any PDF 2.0 input (PDF/A-3 needs a %PDF-1.n header).set_metadata writes to XMP and adds no Info entries (ISO 32000-2 §14.3.3); on a PDF/UA-2 input it also moves the existing Info entries to XMP and removes them (ISO 14289-2 §6.2).add_annotation and tag_form_fields add to a PDF/UA-2 file have no /NS, so they sit in the PDF 1.7 namespace (§8.2.4 allows it); warnings says so.Every tool result carries output, read back from the written file:
{ "output": { "pdfVersion": "2.0", "declares": { "pdfua": 2, "pdfa": "4" } } }
declares.pdfua is pdfuaid:part; declares.pdfa joins pdfaid:part and pdfaid:conformance ("3b", "4", "4f"). A key is absent when nothing is declared. A declaration is only a claim — measure it with pdf-verify-mcp.
When a tool rewrites the XMP (set_metadata, ensure_pdfa), the values you did not pass are carried over as written: the other languages of dc:title, every name in dc:creator, and properties in namespaces this server does not know. Changing title replaces the x-default entry and names the other languages in warnings.
| Tool | Purpose |
|---|---|
merge_pdfs | Concatenate 2–50 PDFs in order; metadata inherited from the first file. Inputs that mix PDF 2.0 and PDF 1.x need pdfVersion: "2.0" |
split_pdf | One output file per page range |
extract_pages | Extract pages in the requested order (doubles as reordering) |
delete_pages | Remove pages (deleting every page is rejected) |
reorder_pages | Reorder by an explicit permutation of all pages |
rotate_pages | Rotate clockwise (90/180/270), accumulating over existing rotation. Edits in place, so the warning below does not apply |
[!WARNING]
The five tools other than `rotate_pages` rebuild the document from its pages.
- Carried over: attachments (
/Names /EmbeddedFiles,/AF),/Lang,/ViewerPreferences,/OutputIntents
- Not carried over: the tagged structure tree, XMP, and anything tied to page numbers or page references (bookmarks, page labels, named destinations)
- Whatever is lost is reported in
warnings— nothing disappears silently
Page specs use "1,3-5,8-" (1-based; -3 means up to page 3, 8- means page 8 to the end). Order is preserved and duplicates are removed.
| Tool | Purpose | |
|---|---|---|
set_metadata | Update Info dictionary fields (title / author / subject / keywords / creator), preserving the rest. On documents carrying XMP, dc:title etc. are kept in sync (PDF/UA and PDF/A declarations preserved). tdmReservation (0 \ | 1) and tdmPolicy write the W3C TDMRep rights statement to XMP (tdm:reservation / tdm:policy, namespace http://www.w3.org/ns/tdmrep/); a document without XMP gets one, and a PDF/A document also gets the schema described in pdfaExtension:schemas, so veraPDF does not fail ISO 19005-2 6.6.2.3 on it (v0.22.0) |
add_bookmarks | Set the outline (bookmarks); nestable via children, replaces any existing outline | |
add_annotation | Add a sticky note (text), highlight, or square annotation. On tagged PDFs the annotation is nested in an Annot element and stays PDF/UA conformant — pass alt to describe it. On PDF/UA-2, alt is also written as Contents (§8.9.4.2 requires them to match), and a different contents is refused | |
attach_file | Embed a file (/Names /EmbeddedFiles + catalog /AF + /AFRelationship) — the PDF/A-3 shape | |
stamp_page_numbers | Stamp page numbers ({n} / {total}, six positions, pages, startAt). Becomes an artifact on tagged PDFs, so conformance holds | |
fill_form | Fill AcroForm fields. Japanese values via an embedded font; can flatten in the same pass | |
flatten_form | Flatten a form into static content. Refuses tagged PDFs by default (breaks PDF/UA) | |
tag_form_fields | Repair the form inside a tagged PDF for PDF/UA-1 (nest widgets in Form, set /Tabs S, add /TU alternate names; pass labels for human-readable names). On PDF/UA-2, widgets also get /Contents (§8.10.2.3). Idempotent | |
ensure_tagged | Put an existing PDF into the PDF/UA-1 container → Scaffolding an untagged PDF | |
ensure_pdfa | Put an existing PDF into the PDF/A-3b / PDF/A-4 / PDF/A-4f container (flavour) → The archival container | |
add_watermark | Overlay a diagonal watermark ("社外秘" / "DRAFT"). Behind the body content by default; artifact on tagged PDFs |
Shared options: outputPath, returnBase64, allowBreakingSignatures.
[!IMPORTANT]
Editing signed PDFs: an ordinary sa