> [!NOTE]
> 此 README 由 [SKILL](https://github.com/agenvoy/skill-readme-generate) 生成，英文版請參閱 [這裡](https://github.com/pardnio/pdf2image/blob/main/README.md)。

***

<p align="center">
<strong>TURN ANY PDF INTO IMAGES RIGHT IN THE BROWSER!</strong>
</p>

<p align="center">
<a href="https://www.npmjs.com/package/@pardnchiu/pdf2image"><img src="https://img.shields.io/npm/v/@pardnchiu/pdf2image?include_prereleases&style=for-the-badge" alt="npm"></a>
<a href="https://www.jsdelivr.com/package/npm/@pardnchiu/pdf2image"><img src="https://img.shields.io/jsdelivr/npm/hm/@pardnchiu/pdf2image?include_prereleases&style=for-the-badge" alt="Downloads"></a>
<a href="https://www.npmjs.com/package/@pardnchiu/pdf2image"><img src="https://img.shields.io/npm/l/@pardnchiu/pdf2image?include_prereleases&style=for-the-badge" alt="License"></a>
</p>

***

> JavaScript 瀏覽器函式庫，具備 PDF 逐頁轉圖片、即時進度遮罩與 ZIP 一鍵打包下載

## 目錄

- [功能特點](#功能特點)
- [架構](#架構)
- [授權](#授權)
- [Author](#author)

## 功能特點

> `npm i @pardnchiu/pdf2image` · [完整文件](https://github.com/pardnio/pdf2image/blob/main/doc/doc.zh.md)

- **純前端轉檔** — PDF 在瀏覽器內由 pdf.js 渲染成 PNG、JPG 或 WebP，檔案不必上傳到任何伺服器。
- **零設定相依載入** — 引入單一 script 即自動從 CDN 預連線並載入 pdf.js、JSZip 與樣式表，無需手動管理相依。
- **頁面併發渲染** — 所有頁面同時以 canvas 渲染，搭配可調 `scale` 在畫質與速度間取捨。
- **內建進度遮罩** — 轉檔與壓縮過程自動顯示百分比遮罩，並依瀏覽器語系切換中英文提示。
- **ZIP 一鍵下載** — 轉出的圖片以 JSZip 打包，檔名支援 `yyyy-MM-DD hh:mm` 日期樣板自動命名。

## 架構

> [完整架構](https://github.com/pardnio/pdf2image/blob/main/doc/architecture.zh.md)

```mermaid
graph TB
    Script[pdf2image.js 載入] --> CDN[CDN 相依注入<br/>pdf.js / JSZip / CSS]
    App[呼叫端] --> Converter[pdf2image 類別]
    Converter -->|convert| PDFJS[pdf.js 渲染<br/>canvas → Data URL]
    Converter -->|download| ZIP[JSZip 打包<br/>Blob 下載]
    PDFJS --> Loading[進度遮罩]
    ZIP --> Loading
    PDFJS --> Images[images 陣列]
```

## 授權

本專案採用 [MIT LICENSE](https://github.com/pardnio/pdf2image/blob/main/LICENSE)。

## Author

Just [open an issue](https://github.com/pardnchiu/pdf2image/issues/new) to share an idea.

<a href="https://github.com/pardnchiu/pdf2image/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=pardnchiu/pdf2image&cache_bust=2026-10-04" alt="pdf2image contributors" />
</a>

***

©️ 2024 [邱敬幃 Pardn Chiu](https://www.linkedin.com/in/pardnchiu)