```meta
title: @pdf — uma página de um PDF, desenhada na página
description: Uma página (ou algumas) de um PDF enviado para este site, desenhada no texto; um clique abre o PDF no visualizador, naquela página.
```

_flows.md · documentação · [Blocos](/@docs/blocks)_

# @pdf

Uma página de um PDF enviado para este site, desenhada no meio do texto — a figura 3 de um relatório, o slide 12 de uma aula —, sem cortar a figura do documento. Só os bytes daquela página são baixados, e um clique abre o PDF no visualizador do site, naquela página.

## Por que não está desenhado aqui

O `@pdf` desenha um arquivo que a página guarda: um PDF enviado para este site, com o endereço `/f/…` que ele ganhou. Estas páginas de documentação não guardam arquivos, então um `@pdf` aqui não teria o que desenhar.

## O markdown

~~~text
```@pdf src:/f/k3Fq9ZrX2mB7vT1wLp8sYa/relatorio-anual.pdf page:12 title:"Figura 3: vendas por trimestre"
```
~~~

Duas páginas seguidas de um livro, uma embaixo da outra:

~~~text
```@pdf src:/f/k3Fq9ZrX2mB7vT1wLp8sYa/relatorio-anual.pdf pages:18-19
```
~~~

Sem script, ou impresso, o bloco é um link para o visualizador naquela página. Um link comum também abre o visualizador numa página: `[Figura 3](/f/…/relatorio-anual.pdf#page=12)`.

## Argumentos

- `src` — o endereço do PDF neste site, como o `files` o lista. Obrigatório.
- `page` — a página desenhada (1 se não disser).
- `pages` — um intervalo, `18-19`, até 4 páginas, em vez de `page`.
- `title` — uma linha embaixo da página.
- `height` — a altura máxima em pixels; sem ela, a página ocupa a largura da coluna.

## O que precisa

Um PDF enviado para a página: arraste-o para o editor, ou use o `upload` do MCP, e o `files` mostra o endereço.