# 快速开始 (Quickstart)

5 分钟上手 yakultpdf。

## 0. 安装

```bash
pip install yakultpdf
```

---

## 方式一：直接使用 (Standalone)

适合：单文件转换、临时任务。无需初始化。

```bash
yakultpdf convert demo.md
```

完成后，PDF 会出现在当前目录。
- 想要管理多个文档？考虑使用 [工作区模式](01.工作区使用指南.md)。
- 想要更漂亮的排版？阅读 [模板语法指南](04.模板语法指南.md)。

---

## 方式二：带工作区使用 (Workspace)

适合：书籍、项目文档、需要图片管理的场景。

### 1. 初始化

创建目录并生成标准结构：

```bash
mkdir my-docs && cd my-docs
yakultpdf init .
```

### 2. 放入内容

将 Markdown 文件放入当前目录。（例如 `index.md`）

### 3. 转换

```bash
yakultpdf convert index.md
```

完成后，PDF 会出现在 `out/` 目录。
