Presto 文档

简体中文

English

简体中文

English

主题

AI + Skills 直调模板 ​

这篇教程教什么 ​

你将学会用 AI 直接调用 Presto 模板，不用打开 Presto 应用也能完成 Markdown 到 Typst 的转换。只要在 Claude Code 里说一句话，AI 就会自动找到模板、读取文件、执行转换。

  • 预计时间： 15-20 分钟
  • 最终产出物： 用 AI 命令行完成一次 Markdown -> Typst 转换
  • 前置条件： 已安装 Presto（有模板）、已安装 Claude Code

准备好了吗？我们开始。

第一部分：安装 Presto Skill ​

Claude Code 的 Skill 机制让 AI 自动识别你的意图并调用对应工具。我们需要把 presto-convert Skill 放到 Claude Code 能读取的位置。

方式一：安装到当前项目（推荐） ​

适合在某个项目里频繁使用 Presto 转换：

bash
mkdir -p .claude/skills/presto-convert
cp ~/Developer/Presto-io/Presto-doc/skills/presto-convert/SKILL.md \
   .claude/skills/presto-convert/SKILL.md

方式二：安装到全局目录 ​

适合在任何目录下都能使用：

bash
mkdir -p ~/.claude/skills/presto-convert
cp ~/Developer/Presto-io/Presto-doc/skills/presto-convert/SKILL.md \
   ~/.claude/skills/presto-convert/SKILL.md

验证安装 ​

打开 Claude Code，随便提一句和 Presto 模板相关的话，比如"帮我看看有哪些 Presto 模板"。如果 AI 能识别到 Skill 并开始扫描 ~/.presto/templates/ 目录，说明安装成功。

第二部分：查看已安装模板 ​

安装好 Skill 后，先看看你本地有哪些模板可用。

对话重放 ​

👤 帮我看看本地安装了哪些 Presto 模板？

🤖 我来扫描一下你的模板目录。

bash
ls ~/.presto/templates/

你本地安装了以下模板：

模板名称目录
letter~/.presto/templates/letter/
report~/.presto/templates/report/

我再查一下每个模板的详细信息。

bash
~/.presto/templates/letter/presto-template-letter --manifest
json
{
  "name": "letter",
  "version": "0.1.0",
  "description": "中文商务信函模板",
  "author": "Presto"
}
bash
~/.presto/templates/report/presto-template-report --manifest
json
{
  "name": "report",
  "version": "0.1.0",
  "description": "技术报告模板",
  "author": "Presto"
}

你有两个模板：

  • letter — 中文商务信函模板
  • report — 技术报告模板

想用哪个模板转换文档？

验证点 ​

你应该能看到模板名称和描述。如果 ~/.presto/templates/ 目录为空，说明还没有安装任何模板，需要先通过 Presto 应用安装。

第三部分：用 AI 转换文档 ​

现在来做一次完整的转换。假设你有一个 Markdown 文件想转成 Typst。

对话重放 ​

👤 用 letter 模板把 ./notes/meeting-2026-03.md 转换成 Typst

🤖 我先看一下这个文件的内容。

bash
cat ./notes/meeting-2026-03.md
markdown
---
to: 张总
from: 李明
date: 2026-03-01
subject: Q1 项目进度汇报
---

尊敬的张总：

本季度项目进展顺利，主要完成了以下工作：

1. 完成核心模块开发
2. 通过安全审计
3. 用户测试反馈良好

请审阅。

内容确认，现在用 letter 模板转换。

bash
cat ./notes/meeting-2026-03.md | ~/.presto/templates/letter/presto-template-letter > ./notes/meeting-2026-03.typ

转换完成。生成的 Typst 文件保存在 ./notes/meeting-2026-03.typ，我看一下输出内容：

bash
cat ./notes/meeting-2026-03.typ
typst
#import "@preview/letter:0.1.0": *

#show: letter.with(
  to: "张总",
  from: "李明",
  date: "2026-03-01",
  subject: "Q1 项目进度汇报",
)

尊敬的张总：

本季度项目进展顺利，主要完成了以下工作：

+ 完成核心模块开发
+ 通过安全审计
+ 用户测试反馈良好

请审阅。

Typst 源码已生成。如果你本地装了 typst CLI，我可以进一步编译成 PDF。

验证点 ​

检查输出的 .typ 文件是否存在，内容是否包含 Typst 格式代码。

第四部分：进阶用法 ​

掌握基本转换后，这里是一些实用技巧。

批量转换多个文件 ​

👤 把 ./notes/ 下所有 .md 文件都用 report 模板转换

AI 会遍历目录，逐个执行转换：

bash
for f in ./notes/*.md; do
  cat "$f" | ~/.presto/templates/report/presto-template-report \
    > "${f%.md}.typ"
done

指定输出路径 ​

👤 用 letter 模板转换 draft.md，输出到 ./output/draft.typ

AI 会自动创建目录并输出到指定位置：

bash
mkdir -p ./output
cat draft.md | ~/.presto/templates/letter/presto-template-letter \
  > ./output/draft.typ

查看模板的示例文档 ​

想知道某个模板期望什么格式的输入？用 --example 查看：

bash
~/.presto/templates/letter/presto-template-letter --example

这会输出一份示例 Markdown，展示该模板支持的 frontmatter 字段和正文结构。

编译为 PDF ​

如果你安装了 typst CLI，可以一步到位生成 PDF：

bash
cat input.md | ~/.presto/templates/letter/presto-template-letter \
  | typst compile - output.pdf

或者分两步走：

bash
# 先转 Typst
cat input.md | ~/.presto/templates/letter/presto-template-letter > output.typ
# 再编译 PDF
typst compile output.typ output.pdf

下一步 ​

这篇教程覆盖了从安装 Skill 到完成转换的完整流程。接下来你可以：

Presto — Markdown to PDF