Referencia

#Referencia

Configuración del proveedor

proporcionarMarkpdf (independiente)
MarkpdfModule.forRoot (NgModule)

import { provideMarkpdf } from "@markpdf/angular";

provideMarkpdf({
  baseUrl: string,              // ruta o URL de TU backend, no de la API directamente
  convertPath?: string,         // default "/convert"
  streamPath?: string,          // default "/convert/stream"
  indexPath?: string,           // default "/pdf/index"
  jobsPath?: string,            // default "/jobs"
  withCredentials?: boolean,    // default false
});

import { MarkpdfModule } from "@markpdf/angular";

@NgModule({
  imports: [MarkpdfModule.forRoot({ baseUrl: "/api/markpdf" })],
})
export class AppModule {}

@markpdf/angular no acepta una opción apiKey. Está diseñado para hablar con tu propio backend, que es quien conoce la clave. Consulte la Guía marco.

`MarkpdfService`

Inyectable en cualquier componente, directiva o servicio:

import { inject } from "@angular/core";
import { MarkpdfService } from "@markpdf/angular";

const markpdf = inject(MarkpdfService);

`convertFile`

convertFile(
  file: File | Blob,
  options?: ConvertOptions,
  http?: { reportProgress?: boolean }
): Observable<string | ConversionResult | UploadEvent>

Sube el archivo a tu backend (baseUrl + convertPath). Devoluciones:

Observable<string> por defecto.
Observable<ConversionResult> si options.responseFormat === "json".
Observable<UploadEvent> si http.reportProgress === true (emite eventos de progreso y un evento final { type: "result", markdown } o { type: "result", ...ConversionResult }).

`convertFromUrl`

convertFromUrl(
  url: string,
  options?: ConvertOptions
): Observable<string | ConversionResult>

`convertStream`

convertStream(
  input: { file: File | Blob } | { url: string },
  options?: StreamOptions
): Observable<string>

Emite un valor por cada fragmento de Markdown recibido (usa fetch con ReadableStream internamente, envuelto en un Observable). Suscríbete y concatena los valores en orden.

`pdfIndex`

pdfIndex(url: string, filename?: string): Observable<PdfSpine>

`getJob`

getJob(jobId: string): Observable<JobStatus>

`ConvertOptions`

Los mismos campos que el resto de los SDK, en camelCase; consulte Parámetros de API:

interface ConvertOptions {
  inputFormat?: InputFormat;
  mode?: ConvertMode;
  engine?: Engine;
  clean?: boolean;
  imageOcr?: boolean;
  hybridOcr?: boolean;
  responseFormat?: "markdown" | "json";
  pages?: string;
  outputUrl?: string;
  outputEncoding?: "identity" | "gzip" | "zstd";
  outputHeadUrl?: string;
}

Progreso de la carga

type UploadEvent =
  | { type: "progress"; loaded: number; total: number; percent: number }
  | { type: "result"; markdown: string }
  | { type: "result"; markdown: string; engine: string; timings: Timings; /* ...resto de ConversionResult */ };

this.markpdf.convertFile(file, { mode: "fast" }, { reportProgress: true }).subscribe((event) => {
  switch (event.type) {
    case "progress":
      this.percent.set(event.percent);
      break;
    case "result":
      this.markdown.set(event.markdown);
      break;
  }
});

Internamente utiliza HttpClient con reportProgress: true y observe: "events", filtrando y reasignando eventos Angular (HttpEventType.UploadProgress, HttpEventType.Response) a la forma simplificada UploadEvent.

Tipos

interface ConversionResult {
  markdown: string;
  filename: string;
  inputFormat: string;
  engine: string;
  sizeBytes: number;
  markdownBytes: number;
  tokenSavedEstimate: number;
  timings: Timings;
}

interface PdfSpine {
  pageCount: number;
  sections: Array<{ page: number; level: number; text: string }>;
  pages: Array<{ page: number; chars: number; firstLine: string }>;
  pagesTruncated: boolean;
  estimatedTokensFull: number;
  estimatedTokensSpineOnly: number;
}

interface JobStatus {
  jobId: string;
  status: "queued" | "processing" | "completed" | "failed";
  body?: string | Record<string, unknown>;
  error?: string;
}

Todos se exportan desde @markpdf/angular.

Python

Node.js / TypeScript

C++

Next.js

Angular

React

React Native

Svelte

Bun

Flutter

Java

Kotlin

Configuración del proveedor

`MarkpdfService`

`convertFile`

`convertFromUrl`

`convertStream`

`pdfIndex`

`getJob`

`ConvertOptions`

Progreso de la carga

Tipos

​Configuración del proveedor

​MarkpdfService

​convertFile

​convertFromUrl

​convertStream

​pdfIndex

​getJob

​ConvertOptions

​Progreso de la carga

​Tipos

Configuración del proveedor

`MarkpdfService`

`convertFile`

`convertFromUrl`

`convertStream`

`pdfIndex`

`getJob`

`ConvertOptions`

Progreso de la carga

Tipos