博客和技术文章中的场景配图

工程博客、Medium / Substack 文章、GitHub README 和自动驾驶技术文章经常需要清晰的场景图：你要解释的交叉口、讨论的临界工况、代码推理的车道布局。drawtonomy 正好适合这类配图，输出格式专为网络优化。

这一页是博客和文章配图的使用案例，类似于学术论文配图的逻辑 —— 同一画布，不同输出限制。

博客和文章配图的需求

配图约束与学术论文不同：

• 可嵌入。 图片直接放入 Markdown / MDX / Notion / Ghost / Substack 编辑器，无需转换。
• 亮色和深色兼容。 许多工程博客同时提供两种显示模式。配图在两种背景下都应可读，或准备深色版本。
• 文件小。 4 MB 光栅图像会拖累页面加载和 SEO。SVG 或压缩 PNG 是正确的默认选择。
• 社交卡友好。 文章在 Twitter / LinkedIn / Hacker News 分享时，OG 图像通常就是这个配图。宽高比和小尺寸下的清晰度很关键。
• 可编辑。 博主会更新文章。配图需要支持后续编辑而不用重新绘制。

drawtonomy 的默认设置完美对应这些需求：

• .drawtonomy.svg（drawtonomy 的原生 SVG 格式）本身就是标准 SVG，可以嵌入任何 HTML / Markdown / MDX 环境 —— 而且当文章需要更新时，可以直接在 drawtonomy 中再次编辑。
• PNG 导出 支持高 DPI，当不支持 SVG 时使用（比如 LinkedIn 预览）。
• 无限画布 让你绘制宽幅图片，裁切成 OG 图像尺寸。

推荐工作流

一个典型博客配图的可重复流程：

1. 选择场景。 一个场景，一个核心点。不要试图在单张图里说明整条流水线。
2. 在 drawtonomy.com 草绘。 道路、车道、交叉口、车辆、行人、路线、文字标签。
3. 适配亮色和深色模式。 选择在 #fff 和 #1a1a1a 背景下都能看清的颜色。避免纯白描边（亮色背景下不可见）和纯黑描边（深色背景下不可见）。中等灰色描边在两种模式下表现都不错。
4. 设置画布裁切区域。 把配图放置到中心，最相关的内容在视野中央。如果要用同一张图作为 OG 卡，按大约 1200 × 630 的比例取景。
5. 保存为 .drawtonomy.svg。 这是可编辑的源文件。大多数博客文章发布后至少会更新一次 —— 修正笔误、更正内容、“我在续篇中加了相关图示” —— .drawtonomy.svg 让每次更新都只需编辑而非重绘。
6. 导出实际使用的资源。 从同一个场景导出：
   • .png 1200 × 630 作为 OG 卡（LinkedIn / X / Hacker News 预览）。
   • 扁平 SVG 用于文章正文，如果博客平台偏好普通 SVG 而非 .drawtonomy.svg（大多数现代平台两种都接受，因为两个都是标准 SVG）。
7. 嵌入。 放入博客编辑器。加上图片说明 —— 搜索引擎和屏幕阅读器都会用到。

尺寸和分辨率

SVG 不需要考虑分辨率，图片会按布局调整。PNG 需要指定尺寸：

用途	推荐尺寸
博客内嵌图（全宽）	1600 × 900
博客内嵌图（半宽）	800 × 450
OG / 社交卡	1200 × 630
Twitter 卡	1200 × 600
LinkedIn 分享图	1200 × 627
GitHub README 英雄图	1200 × 600（或 README 布局规定的尺寸）

嵌入示例

在 Markdown / MDX（Astro、Next.js、基于 MDX 的博客）中：

![插入场景：自车 90 km/h，插入车 +20 km/h](./cut-in.svg)

在 HTML 中支持深色模式变体：

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="./cut-in-dark.svg">
  <img src="./cut-in.svg" alt="插入场景：自车 90 km/h，插入车 +20 km/h" loading="lazy" decoding="async">
</picture>

在 GitHub README 中附带社交卡元数据（结合 og-image 或类似工具）：

![插入场景图](./docs/img/cut-in.png)

技术文章的风格建议

• 一个配图讲一个场景。 如果文章分别讲三个场景，就画三张图。
• 在图上标注。 短标签（“TTC = 2.5 s”）直接嵌在图里，可以节省读者眼力；长解释留给旁边的文字。
• 系列文章中保持自车风格一致。 如果这是系列文章，选定一种自车颜色并在所有配图中保持一致。
• 无专有截图。 用 drawtonomy 的通用化场景图而不是模拟器截图，可以避免”这是从仿真器导出的吗？“这样的疑问，也让你对重用权充满自信。

不适用的场景

• 光真写实插图。 drawtonomy 严格是俯视 2D。如果需要渲染某个传感器的第一人称视图，用仿真器截图。
• 动画。 drawtonomy 导出静止图片。如果需要动画的场景讲解（比如插入动作随时间推移），导出静止图后另行动画处理，或用 OpenSCENARIO 导出配合 esmini 做回放。

相关阅读

• 学术论文配图 —— 学术论文的使用案例。
• 设计评审幻灯片 —— 幻灯片的使用案例。
• 插入和变道场景可视化 —— 你经常会画的几个典型场景。
• 导出你的场景 —— SVG / PNG / PDF / EPS 细节说明。