Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Konwersja i formaty

pdf-generation

/pdf-generation

Składa Markdown w PDF przez Typst, bez LaTeX-a: raporty, książki, listy i notatki, z układem dopasowanym do typu dokumentu.

Repozytorium
pdf-generation ↗
Licencja
MIT
Ostatnia zmiana repozytorium
09.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
6
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Składa Markdown w PDF przez Typst, bez LaTeX-a: raporty, książki, listy i notatki, z układem dopasowanym do typu dokumentu.

Oryginalny opis (EN)

把 Markdown 排成 PDF(Typst 排版,不装 LaTeX):报告、白皮书、信函、书稿、教材、小说、笔记。当用户要把 .md 转成 PDF、按某种文档类型排版、或调整已有 PDF 的版式与观感时使用。

Jak działa

  1. 1. 扫描
  2. 2. Clarify:只问会改变成品的选择
  3. 3. 落 Spec
  4. 4. 生成
  5. 5. 抽页目检
  6. 6. 调整
  7. Kind 速查
  8. 内容速查
  9. 参考
Sekcje z nagłówków SKILL.md, w oryginale · 141 linii, 499 słów
Podgląd SKILL.md
---
name: pdf-generation
description: 把 Markdown 排成 PDF(Typst 排版,不装 LaTeX):报告、白皮书、信函、书稿、教材、小说、笔记。当用户要把 .md 转成 PDF、按某种文档类型排版、或调整已有 PDF 的版式与观感时使用。
---

# PDF Generation

pandoc 把 Markdown 解析成 Typst 源码(`-f` 默认是钉死的 pandoc markdown 扩展串,见 `--from`),版式由本 skill 自带的模板承担,`typst` 直接渲染 PDF。七种 Kind、一个 Style spec、一条固定流程。

流程六步;每一步末尾的完成判据不成立,就不进入下一步。

## 1. 扫描

```bash
python scripts/build_pdf.py detect <输入文件...>
```

拿到 JSON:`suggested_kind`、`lang`、字数、标题层级、frontmatter 键,以及 `features` 里的特征位(表格、代码、公式、图片、引文、交叉引用、边注、图表、棋谱……)。

**完成判据**:你能说出建议 Kind、语言,以及 JSON 里 `features` 为 `true` 的每一项打算怎么排(引文用哪套样式、图表交给哪个渲染器、棋谱用哪种围栏)。

## 2. Clarify:只问会改变成品的选择

一轮问完,最多 8 个问题;每题给 2–4 个选项、一个**推荐值**和一句理由;末尾附「全部按推荐」。

| # | 问题 | 何时问 | 推荐值 |
|---|------|--------|--------|
| 1 | Kind | 检测结果与内容有歧义 | `detect` 的 `suggested_kind` |
| 2 | 语言 / 字体 | 中英混排且用户没提 | 正文含中文 → 中文预设;纯英文 → 英文预设 |
| 3 | 纸张 | 用户没提且不是书稿 | 见下表默认纸张 |
| 4 | 封面元信息 | 要做封面但缺报告人/机构/日期 | 从 frontmatter 补;缺的留空,交付时说明 |
| 5 | 配色 | 用户没提 | `teal`;正式场合用 `mono` |
| 6 | 代码行号 | 源文件含代码块且用户没提 | 不加行号(`code.line-numbers=false`);要引用具体行时再加 |
| 7 | 引文样式 | `detect` 报 `citation: true`,或用户提到参考文献 | 按语言默认:中文 GB/T 7714、英文 IEEE、`article` 用 APA |
| 8 | 边注 | 脚注较多,或 Kind 是 `textbook` | `textbook` 用页边;其余保持页脚 |

字号、行距、页边距、目录深度、代码主题留到第 6 步,第一版一律用 Kind 默认值。

三类答案直接沿用,不再发问:frontmatter 里已有的元数据、用户消息里已经说过的、以及 `detect` 能确定的事实。

Kind 与内容明显匹配时(frontmatter 已有 `letter:` 字段、一级标题构成多章书稿),走**声明式自动确认**:说一句「我按 letter / A4 / 无目录 排」,直接进入第 3 步,不停下来等回复。用户想改会自己说。

用户说「你定 / 随便 / 看着办」:整轮跳过,全部取推荐值。

有结构化提问工具就用(DSH 的 `ask_user_question`、Claude Code 的 `AskUserQuestion`),没有就把问题写成编号文本。

**完成判据**:每个不确定项都有答案(问到的,或明确取默认的),并且你能写出一句「按 X Kind、Y 纸张、Z 配色生成」。

## 3. 落 Spec

把与默认不同的答案写进 `<首个输入文件同名>.doc.yml`:

```yaml
kind: report
style:
  color:
    palette: indigo
  page:
    margin: 2.4cm
```

`kind` 也可以写在 Markdown frontmatter 里。全部取默认时跳过本步。

**完成判据**:`doc.yml` 已存在,或你确认本轮全部使用默认值。

## 4. 生成

```bash
python scripts/build_pdf.py build <输入文件...> [-o out.pdf] [--kind K] [--doc spec.yml] [--set key=value ...]
```

多文件(书 / 教材 / 小说):第一个文件管元数据,每个文件一章,章序按命令行顺序:

```bash
python scripts/build_pdf.py build book.md ch01.md ch02.md
```

产物三件:`<stem>.pdf`(交付)、`<stem>.typ`(自包含;手工编译用文件头那行现成命令,需要时带 `--root` / `--package-path`)、`<stem>/` 下的抽页 PNG。

**完成判据**:命令退出码为 0,且输出里有 `PDF ... (N 页)`。

## 5. 抽页目检

用读图能力打开构建打印出的 PNG。默认抽文档中部的一页正文;出现 warning(缺字体、内容溢出)时自动多抽封面和前几页。

看三件事:字体是否成方块、表格/代码是否溢出、封面与目录是否错位。文档里有**棋谱、图表、边注、行号**时,对应那页要单独看一眼:棋盘有没有缺子、图表是否被裁、边注有没有压住正文。

```bash
python scripts/build_pdf.py build doc.md --check all   # 全量逐页
python scripts/build_pdf.py build doc.typ              # 只查已有 .typ
```

**完成判据**:你看过至少一张抽页,并能说出上面三件事各自的状态;文档里有棋谱、图表、边注或行号时,对应那页也看过。

## 6. 调整

用户说「标题太大 / 页边距再宽点 / 换个配色」时,改旋钮,不动正文。优先级从高到低:`--set` > `<stem>.doc.yml` > Kind 默认 > 全局默认;Markdown frontmatter 只提供元数据(标题、作者、`kind`、书目等)。

```bash
python scripts/build_pdf.py style doc.md --write doc.doc.yml   # 导出完整 spec
python scripts/build_pdf.py build doc.md --set heading.size-1=18pt --set color.palette=sepia
```

**完成判据**:新 PDF 已生成,且第 5 步的抽页重新看过一遍。

## Kind 速查

| Kind | 用于 | 默认纸张 |
|------|------|----------|
| `report` | 运营/项目/分析报告(默认) | A4 |
| `article` | 单篇文章、论文式长文 | A4 |
| `letter` | 公函、商务信函 | A4 |
| `note` | 学习/实验笔记,紧凑排版 | A4 |
| `book` | 书稿、白皮书 | 6×9 |
| `textbook` | 教材:定理/例题/习题 | A4 |
| `novel` | 小说:第 N 章、首字下沉 | A5 |

每种 Kind 的封面、目录、编号、页眉细节在 [references/kinds.md](references/kinds.md)。

## 内容速查

正文里能写什么,按「想排成什么」查:

| 想排 | 写法 |
|------|------|
| 引文 + 参考文献 | frontmatter `bibliography: references.bib`,正文 `[@key]` |
| 交叉引用 | `{#fig:x}` + `@fig:x`;公式 `\label{eq:x}` + `\eqref{}` / `@eq:` |
| 边注 | `[文字]{.sidenote}` 或 `::: {.sidenote}` |
| 代码行号 | `--set code.line-numbers=true`,或单块 `{.line-numbers}` |
| 图表 | ```` ```dot ```` / ```` ```mermaid ```` 围栏 |
| 公式编号 | 自动(book/article)或 `--set math.numbering=(1)` |
| 棋谱 | ```` ```fen ```` / ```` ```pgn ```` / ```` ```notation ```` |

引文细节见 [references/citations.md](references/citations.md),棋谱见 [references/chess.md](references/chess.md),其余见 [references/authoring.md](references/authoring.md)。

## 参考

按需读取,不必预先加载:

- [references/style-knobs.md](references/style-knobs.md) — 全部旋钮、取值格式、各 Kind 覆盖表
- [references/troubleshooting.md](references/troubleshooting.md) — 报错与版式问题的处理
- [INSTALL.md](INSTALL.md) — 安装(分「用户」与「Agent」两部分)

Kind 速查与内容速查已经链到 kinds、authoring、citations、chess 四份文档。
Pliki w paczce (6)
  • .gitignore 1 KB
  • CONTEXT.md 4 KB
  • INSTALL.md 8 KB
  • LICENSE 1 KB
  • README.md 7 KB
  • SKILL.md 7 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · SidneyLYZhang/pdf-generation100MIT
glebis/claude-skills100MIT
sjungling/sjungling-claude-plugins100MIT
claude-dev-suite/claude-dev-suite100MIT
Amey-Thakur/AI-SKILLS90MIT

Migawka bazy z 13.11.2026 · wersja paczki a37573eb07a0 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100typst
    Tworzy dokumenty i pakiety w Typst: pisze pliki .typ, szablony i konwertuje Markdown lub LaTeX do Typst.
  • 100typst
    Pisze dokumenty w Typst, np. artykuły, raporty i listy, i kompiluje je do PDF, czytając błędy kompilatora.
  • 100typst
    Podaje referencję języka Typst: składnię, reguły set i show, tabele, szablony i eksport do PDF, HTML lub PNG.
  • 100pdf-converter
    Konwertuje Markdown, HTML, zwykły tekst, obrazy i inne formaty pandoc do PDF przez potok typst, także łączy obrazy w jeden plik.
  • 100typst
    Generuje profesjonalne dokumenty PDF w systemie składu Typst: CV, raporty, prace naukowe z bibliografią, listy, faktury i plakaty, także z CJK.
  • 100md-to-pdf
    Konwertuje dowolny plik markdown na czysty plik PDF, na przykład przy eksporcie dokumentu z pliku .md.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.