​

Guía marco

​

La tecla API en el navegador

• Estás creando un prototipo o construyendo una herramienta interna con acceso controlado.
• Ya tienes una clave de privilegios bajos, con límites de uso ajustados, dedicada únicamente a esa interfaz.
• El “costo” de que alguien use su clave para convertir archivos PDF no es una preocupación real (por ejemplo, herramienta de usuario único, demostración, entorno de prueba).

​

Patrón recomendado para producción: proxy en tu propio backend

1. Cargue el archivo en su propio punto final (/api/convert o similar).
2. Su servidor llama a markpdf con la clave guardada como una variable de entorno del lado del servidor.
3. Su servidor devuelve el Markdown al cliente.

async function upload(file: File) {
  const form = new FormData();
  form.append("file", file);
  const res = await fetch("/api/convert", { method: "POST", body: form });
  return res.text();
}

​

Cuándo usar @markpdf/react directo

• Aplicaciones sin su propio backend (SPA estáticas servidas desde CDN) donde de todos modos no tienes dónde ocultar las claves.
• Herramientas internas detrás de VPN/SSO donde el público que puede ver la clave ya está autorizado a usarla.
• Prototipos y demostraciones.

​

Representación del lado del servidor (SSR) / Componentes del servidor

"use client";

import { MarkpdfProvider } from "@markpdf/react";

export function Providers({ children }: { children: React.ReactNode }) {
  return <MarkpdfProvider apiKey={process.env.NEXT_PUBLIC_MARKPDF_API_KEY!}>{children}</MarkpdfProvider>;
}