# PDF2markdown

**Repository Path**: hellolwp/pdf2markdown

## Basic Information

- **Project Name**: PDF2markdown
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-27
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PDF2markdown

Convert a local PDF into per-page PNG images, upload them to Qiniu Cloud, and output Markdown-ready image links.

## Features
- Windows file picker to select a PDF
- Convert each PDF page to PNG (via PyMuPDF)
- Upload images to Qiniu Cloud
- Output Markdown `![]()` links

## Setup
1. Create and activate a virtual environment (optional but recommended).
2. Install dependencies:

```bash
pip install -r requirements.txt
```

3. Configure Qiniu credentials by creating a `.env` file in the project root with:

```bash
QINIU_ACCESS_KEY=your_access_key
QINIU_SECRET_KEY=your_secret_key
QINIU_BUCKET=bucket_name
QINIU_DOMAIN=https://your.cdn.domain
```

- `QINIU_DOMAIN` should be the full base URL used to access your files, e.g. `https://cdn.example.com` (no trailing slash).

## Usage
Run the CLI and pick a PDF from the dialog. It will convert and upload, then print Markdown image links.

```bash
python src/main.py
```

You can also specify an output DPI and an optional prefix for object keys:

```bash
python src/main.py --dpi 200 --key-prefix myfolder/
```

The tool will create a temporary folder for PNGs and clean it up after upload.