自定义 PDF 模板：打造高级品牌报告

自定义模板能将普通的 Markdown 转换为仿佛出自设计工作室之手的精美文档——你的文字商标、你的排版、你的品牌色，铺满整个页面。只需构建一次，之后导出的每一份报告、提案或简报都能一键保持品牌一致性。

本指南将从头到尾演示一个完整的示例：Aurelia，一份深色、全出血的品牌战略报告。代理机构和顾问通常会向客户发送此类报告，因为客户期望交付物能与工作本身一样经过深思熟虑。按照这些步骤操作，你将在自己的账户中保存一个专属版本，并获得一套可用于发票、商业计划书、工作说明书等文档的定制方案。

最终效果——通过你保存的模板将普通 Markdown 渲染而成。

你将构建什么

Aurelia 刻意营造出一种“昂贵的高级感”，它的每一个部分都可以在构建器中由你掌控：

• 全出血背景——延伸至页面每个边缘的深海军蓝渐变。
• 金色文字商标报头和一行带有字间距的小字号保密声明。
• 衬线排版——用于标题的高对比度展示字体，以及用于正文的优雅书刊衬线体。
• 品牌调色板——暖金色标题、奶油色正文、带有金色边框的引言。
• 真实的文档结构——执行摘要、定位矩阵表和路线图——所有样式都经过精心设计，以确保在深色页面上清晰易读。

开始之前

1. 登录你的账户。构建器位于 Dashboard（仪表盘） → Template builder。
2. 推荐使用付费计划。设计和保存模板是免费的，但要无水印导出——以及使用像 Executive 这样的高级基础模板——需要付费计划。
3. 准备两项素材：
   • 一张透明 PNG 格式的徽标或文字商标。宽而扁平的文字商标（例如 1200×170）非常适合作为纤细的报头。
   • 一张可选的 A4 纵向尺寸（约 1240×1754）的背景图片。深色、低对比度的渐变或纹理效果最佳——过于杂乱的照片会干扰文字阅读。

提示：手头没有背景图片？仅设置纯深色的背景颜色 (Background color) 同样能触发下文所述的高级深色样式，因此你无需上传任何内容即可构建整个模板。

第 1 步 — 打开构建器并命名模板

打开 Dashboard（仪表盘） → Template builder。你将看到三个区域：左侧的 模板库 (Template library)、中间的 布局编辑器 (Page canvas)，以及右侧的 模板检查器 (Template inspector)（所有编辑操作都在这里进行）。

在模板检查器中：

1. 将 名称 (Name) 设置为 Aurelia — Brand Strategy Report。
2. 添加简短的 描述 (Description)，以便日后识别。
3. 将 基础模板 (Base template) 设置为 Executive——这是一个精致的基础模板，具有优雅的标题分隔线和出色的表格样式。
4. 如果希望在转换器中默认选中它，请勾选 设为默认模板 (Set as default template)。

三面板构建器。你在模板检查器中修改的任何内容都会立即更新到页面上。

第 2 步 — 添加全出血页面背景

在模板检查器中，找到 页面外壳 (Page shell) 部分。这控制着页面的外围——即延伸到纸张边缘的部分。

1. 在 背景图片 (Background image) 下，点击 上传背景图片 (Upload background image) 并选择你的深色 A4 素材。它会自动铺满整个页面。
2. 将四个 padding（内边距） 值保持为 0——文档在出血线内已经保留了舒适的边距。
3. 添加一个 遮罩 (Scrim)——覆盖在图片上的一层微妙的半透明蒙版，用于保持文字清晰易读。将 遮罩颜色 (Scrim color) 设置为接近黑色的颜色（如 #05070F），并将 遮罩强度 (Scrim strength) 调整到大约 18%。

没有图片？也可以将 背景颜色 (Background color) 设置为深海军蓝（如 #070B18）。无论哪种方式，构建器都会识别出这是一个深色页面，并自动清除基础模板中针对浅色页面的设计（如白色引用卡片、斑马纹表格行、柔和的粗体强调色），从而让你的色彩干净地呈现出来。

页面外壳：全出血背景加上柔和的遮罩以提高可读性。

第 3 步 — 放置徽标和页脚

继续在模板检查器中，打开 品牌标识 (Branding) 部分：

• 品牌名称 (Brand name)：Aurelia
• 副标题 (Subtitle)：Brand Strategy Studio
• 页脚文本 (Footer text)：Aurelia Brand Studio · Confidential ——这将成为打印在每页底部的页脚。

接下来，在画布上选择 页眉 (Header) 块。在 已选块 (Selected block) 面板中，点击 上传图片 (Upload image) 并选择你的透明文字商标 PNG。它将作为纤细的报头出现在页面顶部。

品牌文本将填充到页眉和页面底部的页脚中。

第 4 步 — 设置页眉文本样式

在仍然选中 页眉 (Header) 块的情况下，滚动 已选块 (Selected block) 面板：

1. 在 文本 (Text) 中，输入一行简短自信的文字：Brand Strategy Studio · Confidential。
2. 将 文本颜色 (Text color) 设置为柔和的暖灰金色（如 #A7A08B），使其显得低调内敛而不张扬。
3. 将 对齐方式 (Alignment) 设置为 居中 (Center)，使其居中显示在文字商标下方。
4. 添加少许 底部外边距 (Margin bottom)（大约 28），将报头与标题隔开。

针对特定块的文本颜色和对齐方式让页眉和页脚文本在深色页面上大放异彩。

第 5 步 — 设置高级排版

这一步是让模板摆脱普通文档感、展现品牌气质的关键。打开 排版 (Typography) 部分，并使用 元素 (Element) 下拉菜单为每个元素设置样式。Aurelia 仅使用了两种字体——克制即是高级。

对于每一行：选择元素，选择 字体 (Font family)，输入 字号 (Font size)，点击 颜色 (Color) 色板，并设置附加项（字间距 (Letter spacing)、变换 (Transform)、行高 (Line height)）。深色模板的关键在于颜色——在这里设置浅色文本颜色，页面就会焕发生机。

逐个元素的排版设置。选择一个元素，然后仅对该元素进行样式设置。

第 6 步 — 预览、测试并保存

1. 展开画布下方的 Exact PDF preview（精确 PDF 预览），查看页面的真实渲染效果。
2. 使用真实内容进行测试。 粘贴一份真实的文档——包含标题、表格、引用、列表——并确认所有内容都清晰易读。Aurelia 能够完美驾驭定位矩阵和路线图。
3. 点击 保存模板 (Save template)。它现在会出现在你的 模板库 (Template library) 中，随时随地可供使用。

真实内容——表格、列表、粗体导语——经过样式设置，在深色页面上依然保持清晰。

第 7 步 — 在转换器中使用你的模板

1. 打开转换器（点击 Convert 链接，或从构建器中点击 打开转换器 (Open converter)）。
2. 粘贴或编写你的 Markdown。
3. 在 已保存的模板 (Saved templates) 下，选择 Aurelia — Brand Strategy Report。
4. 点击 下载高级 PDF (Download Premium PDF)。

就是这样——你的 Markdown 将输出为一份完全符合品牌形象、无水印的报告。

第 8 步 — 使用 API 实现自动化

模板保存后，你可以通过编程方式生成相同的品牌 PDF——非常适合将 AI 输出、CMS 内容或定时报告转换为可直接交付给客户的文档。

1. 创建 API 密钥。 前往 Dashboard（仪表盘） → API keys（API 密钥） 并创建一个。它以 mp_live_ 开头，并且只显示一次，因此请将其复制到安全的地方。

2. 查找模板 ID。 在登录状态下，在浏览器中打开 https://markdowntopdfconverter.com/api/custom-templates。JSON 响应会列出每个已保存模板及其 id——复制你需要的那个。

3. 调用转换端点。 发送你的 Markdown 以及 customTemplateId：

curl -X POST https://markdowntopdfconverter.com/api/v1/convert \
  -H "Authorization: Bearer mp_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "## Northwind Outdoor — Brand Strategy\n\nYour report content in Markdown…",
    "templateId": "executive",
    "customTemplateId": "YOUR_TEMPLATE_ID",
    "filename": "northwind-brand-strategy",
    "options": { "pageNumbers": true }
  }' \
  --output northwind-brand-strategy.pdf

在 Node.js 中的相同请求：

const res = await fetch("https://markdowntopdfconverter.com/api/v1/convert", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MP_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    markdown: "## Northwind Outdoor — Brand Strategy\n\nYour report content…",
    templateId: "executive",
    customTemplateId: "YOUR_TEMPLATE_ID",
    filename: "northwind-brand-strategy",
    options: { pageNumbers: true },
  }),
});

const pdf = Buffer.from(await res.arrayBuffer());

响应内容即为 PDF 文件本身（Content-Type: application/pdf）。传递 customTemplateId 以应用你保存的设计；将 templateId 设置为其基础模板（此处为 executive）。有关所有选项，请参阅完整的 API 文档。

打造高级感的设计提示

• 最多使用两种字体。 将一种展示型衬线体与一种书刊衬线体（或干净的无衬线体）搭配使用。通过字号、字重和颜色来建立层级关系——而不是使用更多的字体。
• 让页面呼吸。 宽裕的行高和柔和的遮罩比任何额外的装饰更能体现“高级感”。
• 刻意制造对比。 在深色页面上，将最亮的色调留给标题，金色留给章节标题，柔和的灰白色留给正文。
• 仅使用透明徽标。 透明 PNG 格式的文字商标可以干净地放置在任何背景上；而带有白色背景框的徽标则不行。
• 交付前进行测试。 务必使用真实内容（长标题、宽表格、代码块）进行预览，以免日后出现意外。

下一步

• 在模板比较指南中对比六个内置的初始模板。
• 刚开始使用本应用？请从入门指南开始。
• 准备好实现自动化了吗？深入了解 API 文档。