常见问题

本文档收录了日经问题（QQ 群中经常有人问的问题），以及官方文档和小蓝书中未提到的一些零碎的使用技巧。

由于问题已有数十个，单页面实在是太长，因此将每个问题拆开了。请活用页面上方的搜索框查找问题。

TIP

阅读本文档之前，推荐首先阅读官方文档和小蓝书。

如果页面上的内容有错误或者对内容有疑问，可以直接提交 issue

问题目录

全部76bib4bug3cetz1chinese11code11counter2equation4figure2font7heading7label2layout13list1math14mermaid1numbering8outline1package1page3pdf1raw2ref1show3spacing1structure1svg1symbol1table7template1text16tool3webapp1word2

layout

• 如何增加标题前后的距离？类似于 Word 的段前段后
• 如何避免公式、图表等块元素的下一行缩进？
• 如何让几个汉字占固定宽度并均匀分布？
• 写中文文档时，如何去掉源码中换行导致的空格？
• 【已修复】代码块中西文间有多余的空格？
• 【已修复】代码块里多了空格/代码块的对齐非常奇怪
• 列表符号和文字错位了怎么办？
• 长公式换行后，上标的位置不对
• 【已修复】为什么第一段没有缩进？
• 如何实现左对齐-居中-右对齐的布局
• 如何实现子图？子图与 i-figured 编号冲突怎么办？
• 如何给文本增加阴影
• 如何实现 Word 中的两倍行距？

如何贡献

修改已有的页面

每个下面下方会都有 在 GitHub 上编辑此页面 按钮，点击即可编辑页面内容。

创建新页面

点击这个链接创建一个新的 .md 文件，编辑完成 commit 后提交 pull request 即可。

https://github.com/typst-doc-cn/guide/new/master/docs/FAQ

模板

---
tags: [template, code]
---

# 问题/页面标题

写一些说明文字。

如果你需要展示 demo，可以像下面这样使用 typst 代码块。

```typst
Let $a$, $b$, and $c$ be the side
lengths of right-angled triangle.
Then, we know that:
$ a^2 + b^2 = c^2 $

Prove by induction:
$ sum_(k=1)^n k = (n(n+1)) / 2 $
```

上面的代码块在生成文档时，会自动调用 typst 编译器生成预览图片并附在代码块后面。从而让网站维护者和读者知道这段代码是可以正常使用的。

如果你的代码片段还需要与其他内容配合，不能直接运行，可以在语言后面加上 no-render，这样的代码块就不会被渲染，例如下面这个：

```typst no-render
// 设置中英文字体
#set text(font: ((name: "New Computer Modern", covers: "latin-in-cjk"), "Noto Serif CJK SC"), lang: "zh")
```

嗯，暂时没有需要补充的了。

注意：渲染器在将文档中的 typst 代码渲染成图片时会自动在前面插入这两行代码，避免生成的图片过大，改善阅读体验。因此需要较大的页面展示代码效果的时候记得手动设置页面尺寸。

#set page(height: 4cm, width: 6cm)
#set text(font: ((name: "New Computer Modern", covers: "latin-in-cjk"), "Source Han Serif SC"))

对于设置页面这种与正文关系不大的代码，可于行首加-- ，在渲染时隐藏。

示例：隐藏代码

.md 文件：

-- #set page(width: auto, height: auto, margin: 1em)
#lorem(1)

渲染结果：

#lorem(1)

最后，如果问题已在新版 typst 修复或改进，可在标题开头添加【已修复】，并注明版本。

# 【已修复】……？

::: tip ✅ Typst 0.0 已修复/已改进
[#000](https://github.com/typst/typst/pull/000) 已经……
:::