reamkit

KO | EN

gitlite — search

#automation #ruby #python #linux #markdown #redis #agent #awesome #web #git

(★ 9)

Read .docx .xlsx .pptx .pdf .doc .xls .ppt → convert to PDF, SVG, HTML, Markdown, DOCX or XLSX — pure TypeScript, no LibreOffice, no headless Office, no commercial SDK

File Explorer

ZIP Download

- - ci.yml
  - docs.yml
  - release.yml
- .pdf-docx-scout.json
- .pdf-docx-vs-lo.json
- .pixel-scout-diffset.json
- .pixel-scout-jbig2-set.json
- .pixel-scout-lo-docx-export.json
- .pixel-scout-lo-docx-import.json
- .pixel-scout-lo-pptx.json
- .pixel-scout-lo-xlsx.json
- .pixel-scout-pdfjs.json
- .pixel-scout-poi-doc.json
- .pixel-scout-poi-docx.json
- .pixel-scout-poi-ppt.json
- .pixel-scout-poi-pptx.json
- .pixel-scout-poi-xls.json
- .pixel-scout-poi-xlsx.json
- README.md
- xlsx-invariants-baseline.json
- - CNAME
  - favicon.svg
  - og.png
  - robots.txt
- - generate-og.mjs
- - content.config.ts
- .gitignore
- astro.config.mjs
- package-lock.json
- package.json
- README.md
- tsconfig.json
- - build-corpus.ts
  - convert-one.ts
  - diff-map.ts
  - fetch-corpus.ts
  - fonts.ts
  - lib.ts
  - loss-report.ts
  - make-golden.ts
  - pdf-docx-pairs.ts
  - pdf-docx-scout.ts
  - pdf-docx-vs-lo.ts
  - pixel-scout.ts
  - roundtrip.ts
  - run.ts
  - scout.ts
  - sources.ts
  - sync-real-fixtures.ts
  - visual-diff.ts
  - xlsx-invariant-child.ts
  - xlsx-invariants.ts
  - xlsx-roundtrip.ts
- build-standard-metrics.ts
- - arc-to-bezier.ts
  - bmp.ts
  - bytes.ts
  - images.ts
  - indexed-colors.ts
  - links.ts
  - lzw.ts
  - number-format.ts
  - outline.ts
  - png-encode.ts
  - po-helpers.ts
  - tiff.ts
  - vector.ts
- - activex-parser.ts
  - cell-reference.ts
  - column-bands.ts
  - comments-parser.ts
  - conditional-format.ts
  - defined-name-ref.ts
  - escaped-text.ts
  - form-control-parser.ts
  - header-footer.ts
  - index.ts
  - pivot-table-parser.ts
  - print-model.ts
  - printer-settings.ts
  - rich-value.ts
  - shared-strings-parser.ts
  - sheet-drawing.ts
  - sheet-shape-parser.ts
  - sheet-to-flow.ts
  - slicer-parser.ts
  - styles-parser.ts
  - table-parser.ts
  - vml-drawing.ts
  - workbook-parser.ts
  - worksheet-parser.ts
  - xlsx-reader.ts
  - xlsx-to-pdf.ts
  - xlsx-writer.ts
- - html-writer.ts
- - math-layout.ts
  - page-doc.ts
  - styled-layout.ts
- - markdown-writer.ts
- - builtin-fonts.ts
  - cid-font.ts
  - embedded-file.ts
  - encryption.ts
  - icc-profile.ts
  - image-xobject.ts
  - index.ts
  - objects.ts
  - serialize.ts
  - shading.ts
  - signature.ts
  - struct-tree.ts
  - styled-page-emitter.ts
  - styled-page-renderer.ts
  - text-encoding.ts
  - text-page-renderer.ts
  - vector-graphics.ts
  - writer.ts
  - xmp.ts
- - annot-draw.ts
  - annots.ts
  - ccitt.ts
  - cff-outline.ts
  - cie-color.ts
  - cmap.ts
  - content.ts
  - decrypt.ts
  - dingbats.ts
  - display.ts
  - document.ts
  - embedded-fonts.ts
  - encodings.ts
  - flow-build.ts
  - font.ts
  - function.ts
  - glyf-outline.ts
  - glyph-names.ts
  - icc.ts
  - image-decode.ts
  - images.ts
  - jbig2.ts
  - jpeg.ts
  - layout.ts
  - lexer.ts
  - math-rows.ts
  - optional-content.ts
  - parser.ts
  - pattern-tint.ts
  - predefined-cmap.ts
  - predictor.ts
  - reader.ts
  - shading.ts
  - standard-metrics.ts
  - standard-widths.ts
  - stream-filters.ts
  - struct-tree.ts
  - tagged.ts
  - text-rules.ts
  - text.ts
  - type1-outline.ts
  - vector.ts
- - embedded-fonts.ts
  - ole-preview.ts
  - placeholder-cascade.ts
  - pptx-reader.ts
  - preset-table-styles.ts
  - slide-parser.ts
  - sp-helpers.ts
  - table-style.ts
- - svg-writer.ts
- - document-parser.ts
  - docx-reader.ts
  - docx-to-pdf.ts
  - docx-writer.ts
  - drawing-parser.ts
  - font-table.ts
  - index.ts
  - numbering-parser.ts
  - omml-parser.ts
  - omml-serializer.ts
  - paragraph-properties.ts
  - po-to-flat.ts
  - run-properties.ts
  - settings-parser.ts
  - shading.ts
  - styles-parser.ts
  - table-parser.ts
  - text-extractor.ts
  - theme-fonts.ts
  - xml-helpers.ts
- index.ts
- - byte-gate.test.ts.snap
- - build-cfb.ts
  - build-compressed-pdf.ts
  - build-doc.ts
  - build-docx.ts
  - build-png.ts
  - build-ppt.ts
  - build-pptx.ts
  - build-xls.ts
  - build-xlsx.ts
  - pdf-show.ts
  - xlsx-dialect.ts
- activex-bin.test.ts
- arabic-joining.test.ts
- arc-to-bezier.test.ts
- bidi-render.test.ts
- bidi.test.ts
- bmp.test.ts
- bookmarks.test.ts
- byte-gate.test.ts
- cfb.test.ts
- chart-geometry.test.ts
- chart.test.ts
- cjk-linebreak.test.ts
- cms.test.ts
- column-bands.test.ts
- columns.test.ts
- comments-docx.test.ts
- conditional-format-expression.test.ts
- conditional-format-extended.test.ts
- conditional-format.test.ts
- data-validation.test.ts
- doc-reader.test.ts
- document-parser.test.ts
- docx-chart-roundtrip.test.ts
- docx-footnotes-roundtrip.test.ts
- docx-math-roundtrip.test.ts
- docx-writer.test.ts
- escher-blip.test.ts
- excel-table.test.ts
- facade.test.ts
- floats.test.ts
- font-families.test.ts
- font-provider.test.ts
- font-scripts.test.ts
- font-table.test.ts
- footnotes.test.ts
- formula-eval.test.ts
- frozen-panes.test.ts
- gradient-fill.test.ts
- html-writer.test.ts
- hyphenation.test.ts
- image.test.ts
- info-metadata.test.ts
- ir.test.ts
- jpeg.test.ts
- knuth-plass.test.ts
- layout-profile.test.ts
- ligatures.test.ts
- line-breaker-greedy.test.ts
- links.test.ts
- markdown-writer.test.ts
- math.test.ts
- metafile.test.ts
- number-format.test.ts
- numbering.test.ts
- offcrypto.test.ts
- opc-package.test.ts
- opc-writer.test.ts
- opentype-layout.test.ts
- page-fields.test.ts
- paragraph-properties.test.ts
- pdf-encryption.test.ts
- pdf-reader-ccitt.test.ts
- pdf-reader-columns.test.ts
- pdf-reader-content.test.ts
- pdf-reader-cos.test.ts
- pdf-reader-crypto.test.ts
- pdf-reader-document.test.ts
- pdf-reader-encrypted-password.test.ts
- pdf-reader-encrypted.test.ts
- pdf-reader-facade.test.ts
- pdf-reader-form-text.test.ts
- pdf-reader-function.test.ts
- pdf-reader-glyph-outline.test.ts
- pdf-reader-icc.test.ts
- pdf-reader-images.test.ts
- pdf-reader-layout.test.ts
- pdf-reader-links.test.ts
- pdf-reader-tagged.test.ts
- pdf-reader-text.test.ts
- pdf-reader-vector.test.ts
- pdf-reader-xref.test.ts
- pdfa.test.ts
- pdfua.test.ts
- pivot-table.test.ts
- ppt-reader.test.ts
- pptx-embedded-fonts.test.ts
- pptx-reader.test.ts
- pptx-slide.test.ts
- preset-geometry.test.ts
- ream.test.ts
- remote-fonts.test.ts
- rich-value.test.ts
- run-properties.test.ts
- section.test.ts
- shape-text-rotation.test.ts
- shape.test.ts
- sheet-activex.test.ts
- sheet-cell-format.test.ts
- sheet-comments.test.ts
- sheet-doc.test.ts
- sheet-form-controls.test.ts
- sheet-header-footer.test.ts
- sheet-hyperlink.test.ts
- sheet-image.test.ts
- sheet-rich-text.test.ts
- sheet-shape.test.ts
- signature.test.ts
- slicer.test.ts
- smartart-docx.test.ts
- smartart-layout.test.ts
- smoke.test.ts
- sparkline.test.ts
- style-cascade.test.ts
- styled-render.test.ts
- styles-parser.test.ts
- table-pagination.test.ts
- table-parser.test.ts
- table-style.test.ts
- table-styles.test.ts
- tagged-pdf.test.ts
- text-warp.test.ts
- theme-fonts.test.ts
- theme.test.ts
- tiff.test.ts
- vector-graphics.test.ts
- verapdf.test.ts
- xls-chart.test.ts
- xls-image.test.ts
- xls-integration.test.ts
- xls-reader.test.ts
- xls-shape.test.ts
- xls-styling.test.ts
- xlsx-alternate-content.test.ts
- xlsx-border-styles.test.ts
- xlsx-cell-newline.test.ts
- xlsx-chart-roundtrip.test.ts
- xlsx-charts.test.ts
- xlsx-default-row-height.test.ts
- xlsx-dialect.test.ts
- xlsx-fit-page-breaks.test.ts
- xlsx-geometry.test.ts
- xlsx-golden.test.ts
- xlsx-real.test.ts
- xlsx-roundtrip.test.ts
- xlsx-shape-anchor-style.test.ts
- xlsx-shape-rotation.test.ts
- xlsx-smartart.test.ts
- xlsx-writer.test.ts
- xlsx-x14-conditional-format.test.ts
- xlsx.test.ts
- xml-internal-entities.test.ts
.gitignore
.prettierignore
.prettierrc.json
CHANGELOG.md
eslint.config.js
LICENSE
package-lock.json
package.json
README.md
tsconfig.eslint.json
tsconfig.json
vite.config.ts
vitest.config.ts

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> Read Word, Excel, PowerPoint and PDF — and convert any of them to PDF, SVG, HTML, Markdown, DOCX or XLSX. From scratch, in the browser. No LibreOffice, no headless Office, no commercial SDK.

Ream parses **seven document formats** — the modern Office Open XML trio (`.docx`,
`.xlsx`, `.pptx`), `.pdf`, and the legacy binary `.doc` / `.xls` / `.ppt` — into one
format-neutral interlayer, then renders that to **PDF, SVG, HTML, Markdown, DOCX or XLSX**.
It is implemented directly from the **ECMA-376** (OOXML), **ISO 32000 / 19005**
(PDF / PDF/A), and Microsoft's binary-format specifications — no wrapper around
LibreOffice, headless Office, or any commercial SDK. Pure TypeScript/JavaScript on
`Uint8Array` in and `Uint8Array` out, so the same code runs unchanged in the browser,
Node.js, serverless and edge runtimes.

|            |                                                                                             |
| ---------- | ------------------------------------------------------------------------------------------- |
| **Reads**  | `.docx` · `.xlsx` · `.pptx` · `.pdf` · legacy `.doc` · `.xls` · `.ppt`                       |
| **Writes** | `.pdf` (incl. PDF/A-1/2/3, PDF/UA-1, signed, encrypted) · `.svg` · `.html` · `.md` · `.docx` · `.xlsx` |

## Install

```sh
npm install reamkit
```

Runtime dependencies are minimal: `fflate` (ZIP/Deflate) and `fast-xml-parser`.

## Usage

Parse once into the format-neutral interlayer, convert to any target. The
format (docx/xlsx) is sniffed from the bytes; no fonts to wire up — an open
metric-compatible substitute font (Arimo for sans, Tinos for serif, Cousine for
monospace, plus Carlito/Caladea for Calibri/Cambria — the same families LibreOffice
substitutes) is fetched automatically based on the document's referenced fonts:

```ts
import { Ream } from 'reamkit';

// e.g. from an <input type="file"> or a fetch() — anything that yields bytes.
const bytes = new Uint8Array(await file.arrayBuffer());

const doc = Ream.parse(bytes);            // docx, xlsx, pptx or pdf — sniffed
const pdf = await doc.convert('pdf');     // async — fetches a font if needed
const svg = await doc.convert('svg');     // same parse, different target
const html = await doc.convert('html');   // flowed HTML — needs no fonts at all
const md   = await doc.convert('md');     // GitHub-Flavored Markdown — same, narrower
const docx = await doc.convert('docx');   // write WordprocessingML back out
const xlsx = await doc.convert('xlsx');   // write SpreadsheetML back (xlsx source)

// Hand the bytes to the browser: preview, download, upload, …
const url = URL.createObjectURL(new Blob([pdf], { type: 'application/pdf' }));
window.open(url);
```

`doc.flow` exposes the parsed document tree, `doc.format` the detected format,
and `doc.convertWithReport(...)` returns `{ bytes, losses }` (pass
`strict: true` to throw on the first conversion loss instead). Input/output
are plain `Uint8Array`s, so wiring this to files, the network, or disk is up
to you.

### Bring your own fonts (no network)

To embed specific fonts — or to avoid the network entirely — pass the font
bytes in. `convert` then does zero I/O:

```ts
const fonts = {
  regular: new Uint8Array(await fetch('/fonts/MyFont-Regular.ttf').then((r) => r.arrayBuffer())),
  bold: new Uint8Array(await fetch('/fonts/MyFont-Bold.ttf').then((r) => r.arrayBuffer())),
  // italic, boldItalic — optional; missing faces degrade gracefully
};

const pdf = await Ream.parse(bytes).convert('pdf', { fonts });
```

### Font resolution chain

For finer control, chain font providers — first byte answer wins. A remote or
local winner is recorded as a `substituted` loss in the report:

```ts
import { Ream, callerFontProvider, localFontProvider, remoteFontProvider } from 'reamkit';

const pdf = await doc.convert('pdf', {
  fontProviders: [
    callerFontProvider(myFonts), // your bytes — highest priority
    localFontProvider(),         // system fonts (Chromium Local Font Access,
                                 //   embedding-restricted fonts are never used)
    remoteFontProvider(),        // open substitute set from CDN, last resort
  ],
});
```

Fonts the document itself embeds (`w:embed`, including obfuscated `.odttf`)
are always used first — glyph-exact, no substitution.

### Archival PDF/A + embedded source

The whole PDF/A family is supported (1a/1b, 2a/2b/2u, 3a/3b/3u —
veraPDF-validated), plus accessible **PDF/UA-1** (`pdfUA: true`, also
veraPDF-validated and combinable with PDF/A in one file). PDF/A-3 can carry
the source document inside the PDF:

```ts
const { bytes: pdfa, losses } = await doc.convertWithReport('pdf', {
  fonts,
  pdfA: 'PDF/A-3b',
  embedSource: true, // the parsed .docx/.xlsx rides along as /AF Source
});
```

### Digital signatures

PKCS#7 detached signatures (ISO 32000 §12.8) via WebCrypto — RSA or ECDSA,
optional PAdES and RFC 3161 timestamping:

```ts
const signed = await doc.convert('pdf', {
  fonts,
  signature: { certificate: certDer, privateKey: cryptoKey },
});
```

### Strict mode and the loss report

Every conversion can report what was dropped, degraded or substituted. For
compliance-critical flows, make any loss fatal:

```ts
const { bytes, losses } = await doc.convertWithReport('pdf', { fonts });
// losses: [{ severity: 'substituted', feature: 'fonts.substitution', … }]

await doc.convert('pdf', { fonts, strict: true }); // throws ConversionLossError on the first loss
```

### Inspect the interlayer

`parse` produces a format-neutral document tree (the interlayer) before any
rendering — inspect or analyze it without converting:

```ts
const doc = Ream.parse(bytes);
doc.format;     // 'docx' | 'xlsx' | 'pptx' | 'pdf'
doc.flow.body;  // paragraphs / tables / images / charts …
doc.losses;     // read-time losses
```

### Hyphenation (optional)

```ts
import { getHyphenator } from 'reamkit';
const hyphenator = await getHyphenator('en-us'); // or 'ru'
const pdf = await doc.convert('pdf', { fonts, hyphenator });
```

### More options

`convert` accepts (beyond the above): `info` (PDF `/Info` metadata — also read
automatically from the document's `docProps/core.xml`), `attachments`
(PDF/A-3 associated files), `tagged` (logical structure without full PDF/A),
`pageWidth`/`pageHeight`/margins overrides.

### Lower-level APIs

- `docxReader` / `xlsxReader`, `svgWriter`, `htmlWriter`, `markdownWriter`, `docxWriter` — the `@experimental`
  reader/writer interfaces of the interlayer, for building custom pipelines (and
  keeping unused formats out of your bundle); `layoutStyledDocument` produces the
  frozen page model (`PageItem` pages in a top-left `Pt` frame) the page-based
  writers consume (`docxWriter` works from the flow model, before layout).
- `renderStyledPdf` drives the layout engine directly; the typed document
  model is on the `reamkit/document-model` subpath.

## Scope

Implemented: WordprocessingML text/styles/tables (incl. table styles)/lists/
multi-section and multi-column layout/headers-footers (incl. PAGE/NUMPAGES
fields)/footnotes and endnotes/hyperlinks and bookmarks/floating drawings/
images/tracked changes, SpreadsheetML grids,
number formats and the print model (gridlines, print area, fit-to-page,
repeated titles, page breaks), **conditional formatting** (color scales, data
bars, icon sets, and `expression` rules evaluated by a ~140-function formula
engine), **sparklines** and **Excel tables**, DrawingML shapes and
charts, OMML math, Type0+CIDFontType2 embedding with subsetting, Knuth-Plass
line breaking, Liang hyphenation, OpenType ligatures/kerning + Arabic cursive
joining, BiDi (UAX #9), hyperlinks (PDF link annotations + HTML anchors,
scheme-allowlisted), tagged PDF, PDF/A-1/2/3 (a/b/u), PDF/UA-1, AES-256
encryption, digital signatures (PKCS#7/ECDSA/PAdES/RFC 3161), SVG page
preview, flowed HTML export, and **docx + xlsx output** (write WordprocessingML
/ SpreadsheetML back out, incl. round-trips). Reads OOXML Transitional and Strict.

**Reads PDF, too.** `Ream.parse` accepts a PDF and reconstructs a `FlowDoc` — a
tagged PDF from its structure tree (headings, tables, lists, reading order), an
untagged one heuristically from glyph positions (lines, paragraphs, headings,
and a clean two-column split). It lifts back the text (via each font's
`/ToUnicode`, or the embedded program's own `cmap` where there is none, or the
glyph names its `/Encoding` states — which is all a PDF from TeX gives), the
font programs themselves, raster images (JPEG verbatim; PNG/Flate/LZW/CCITT-fax
and **JBIG2** decoded and re-encoded), `/Link` hyperlinks, form-XObject content,
annotation appearances (drawing one itself where the file supplies none),
colour set through a named space — device, CIE (`CalGray`, `Lab`) or a
`Separation`/`DeviceN` run through its own tint transform — and the page's
artwork: filled / stroked / gradient shapes, clipping paths, tiling patterns,
stencil image masks, constant alpha, and the Type 3 glyphs that are drawings
rather than letters. It honours the layers a file turns off (§8.11 optional
content) and the box it says to show (`/CropBox`), and it decides for itself
whether a file is a document to re-flow or a page to keep — a paper is mostly
lines, a form is mostly marks — and there is nothing to configure: a caller
cannot know which of the two it was handed. It reads modern compressed files (cross-reference
+ object streams) and encrypted ones (RC4 / AES — the user password is passed to
`Ream.parse(bytes, { password })`, defaulting to the permissions-only case); a
filter it does not carry can be handed to it through
`Ream.parse(bytes, { filters })`.

A form or a drawing is not a reflowable document, so the reader keeps it as a
page instead: every line stands where its glyphs stand, beside the artwork, the
way up the page is shown. Which of the two readings a file gets it decides
itself and records in the losses.

**Reads PowerPoint, too.** `Ream.parse` accepts a `.pptx` and turns each slide
into a page at the deck size — text boxes (with run formatting, alignment,
bullets and indents), layout/master placeholders, pictures, shapes, DrawingML
tables, embedded charts, theme colours, slide backgrounds, grouped shapes and
hyperlinks — then converts onward to PDF, SVG, HTML, Markdown or DOCX like any source.

**Reads legacy `.doc`, `.xls` and `.ppt`, too.** The binary Word / Excel /
PowerPoint 97–2003 formats (OLE2/CFB) parse through a shared container reader: a
`.doc` yields its text with run and paragraph formatting, tables (with cell
borders, vertical merges and background shading), inline images, fields,
headers/footers and lists (numbered or bulleted, in their number format);
an `.xls` yields the grid with styling, embedded
images, charts, drawing shapes, cell hyperlinks, the page-setup print model,
defined names (named ranges, print area, repeated titles), cell comments, data
validation, frozen panes, custom row heights and conditional formatting (the
classic cellIs / expression rules **and** the 2007 colour-scale / data-bar /
icon-set extensions); a `.ppt` yields each slide's
text (with run and paragraph formatting), embedded images, per-shape placement
(anchored text boxes and pictures at their slide rectangles) and decorative
autoshapes (preset or exact freeform geometry, with fill / line colours resolved
through the slide's colour scheme), one page per slide — all convert onward to PDF,
SVG, HTML, Markdown, or back to `.docx` / `.xlsx` like any source.

See [`CHANGELOG.md`](./CHANGELOG.md) for the release history; the docs
[**Scope**](https://reamkit.dev/guides/scope/) guide has the full feature matrix
and known limitations.

## License

reamkit

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

reamkit

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README