> ## 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.

# Inicio rápido

> Tu primera conversión con SDK de Bun en menos de 15 líneas.

# Inicio rápido

## Convertir un archivo local

`convertFile` recibe una ruta y usa `Bun.file(path)` internamente para transmitir el contenido directamente al cuerpo de la solicitud; PDF nunca se carga en su totalidad en `Buffer` JS.

```ts theme={null}
import { MarkpdfClient } from "@markpdf/bun";

const client = new MarkpdfClient({ apiKey: "YOUR_API_KEY" });

const markdown = await client.convertFile("./report.pdf", { mode: "fast" });
console.log(markdown);
```

## Convertir bytes ya cargados en la memoria

Si ya tiene PDF como `Uint8Array`/`ArrayBuffer` (por ejemplo, recibido en `Request`), use `convertBytes`:

```ts theme={null}
const bytes = await Bun.file("./report.pdf").arrayBuffer();
const markdown = await client.convertBytes(bytes, "report.pdf", { mode: "fast" });
```

## Convertir de URL

```ts theme={null}
const markdown = await client.convertFromUrl(
  "https://bucket.example.com/report.pdf?sig=...",
  "report.pdf",
  { mode: "fast" }
);
```

## Solicitar metadatos además de Markdown

```ts theme={null}
const result = await client.convertFile("./report.pdf", {
  responseFormat: "json",
});

console.log(result.markdown);
console.log(result.timings.totalRequestMs);
```

Con `responseFormat: "json"`, SDK devuelve un objeto `ConversionResult` escrito en lugar de `string`. Consulte [Referencia](/docs/public/es/sdks/bun/reference).

## Siguiente paso

* [Referencia completa del cliente](/docs/public/es/sdks/bun/reference)
* [Streaming y trabajos asincrónicos (202)](/docs/public/es/sdks/bun/streaming-and-async)
* [Manejo de errores](/docs/public/es/sdks/bun/error-handling)