> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markpdf.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Tu primera conversión a Markdown.

# Quickstart

Necesitas:

* La URL base de la API.
* Una API key (`x-api-key`).
* Un documento PDF, DOCX, CSV, XLSX, PPTX, TXT o ZIP.

## Convertir un archivo local

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST "https://api.markpdf.tech/convert/raw?filename=informe.pdf&mode=fast" \
    -H "x-api-key: TU_API_KEY" \
    -H "content-type: application/pdf" \
    --data-binary "@informe.pdf"
  ```

  ```python Python theme={null}
  import httpx

  with open("informe.pdf", "rb") as fh:
      r = httpx.post(
          "https://api.markpdf.tech/convert/raw",
          params={"filename": "informe.pdf", "mode": "fast"},
          headers={"x-api-key": "TU_API_KEY", "content-type": "application/pdf"},
          content=fh.read(),
          timeout=300,
      )
  print(r.text)
  ```

  ```javascript JavaScript theme={null}
  const data = await file.arrayBuffer();
  const res = await fetch(
    "https://api.markpdf.tech/convert/raw?filename=informe.pdf&mode=fast",
    {
      method: "POST",
      headers: { "x-api-key": "TU_API_KEY", "content-type": "application/pdf" },
      body: data,
    },
  );
  console.log(await res.text());
  ```
</CodeGroup>

La respuesta por defecto es `text/markdown`.

## Convertir desde URL firmada

```bash theme={null}
curl -X POST "https://api.markpdf.tech/convert/from-url" \
  -H "x-api-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "url": "https://storage.example.com/signed/informe.pdf",
    "filename": "informe.pdf",
    "mode": "fast"
  }'
```

## Modos

| Modo       | Uso                                                      |
| ---------- | -------------------------------------------------------- |
| `fast`     | Máxima velocidad. Recomendado para agentes. Por defecto. |
| `balanced` | Mejor estructura cuando el documento es irregular.       |
| `quality`  | Más lento, mejor para documentos difíciles.              |
| `auto`     | La API decide.                                           |

Detalle en [Modos de conversión](/docs/public/es/concepts/modes).

## Headers útiles

La respuesta incluye headers de observabilidad:

| Header                   | Significado                                                     |
| ------------------------ | --------------------------------------------------------------- |
| `X-Input-Bytes`          | Bytes del documento procesado.                                  |
| `X-Markdown-Bytes`       | Tamaño de la salida Markdown.                                   |
| `X-Token-Saved-Estimate` | Estimación de tokens ahorrados.                                 |
| `X-Conversion-Engine`    | Motor de conversión usado.                                      |
| `ETag`                   | Hash para caché. Ver [Caché](/docs/public/es/concepts/caching). |

Referencia completa en [Respuesta y headers](/docs/public/es/api/response).