# Markdown 转 Typst

把 Markdown 笔记转为 Typst 源码，并在快速的本地写作项目中打开。

Markdown 转 Typst 保留了 Markdown 轻松的开端，并在草稿准备好后为它换上表现力更强的排版系统。常见的结构和公式会随之迁移，而结果仍是你可以随意调整的纯文本源码。

## 适用场景

- 已经发展成报告、讲义或论文的笔记；
- 需要更出色页面设计的 Markdown 草稿；
- 不必重新输入内容就能试用 Typst。

不要只是为了尝鲜而转换。如果代码仓库、静态网站或合作者需要 Markdown，它的可移植性可能比额外的版面控制更有价值。

## 转换源码

1. 打开 **Markdown 转 Typst**，或运行 `/markdown-to-typst`。
2. 粘贴 Markdown。
3. 选择 **转换**。
4. 检查生成的 Typst。
5. 复制它，保存 `converted.typ`，或创建 Typst 项目。

例如，Markdown 的标题、粗体文字、有序列表和以美元符号包围的公式，会变成各自对应的 Typst 写法。转换使用内置的 Pandoc，在本地运行。

## 之后需要调整什么

Markdown 有很多方言。任务列表、原始 HTML、自定义指令、引用扩展和插件语法可能无法带过来。Typst 也需要你自己决定模板、参考文献样式、页面几何设置和可复用的函数。

请编译新项目，并检查：

- 标题层级和列表嵌套；
- 公式和代码块；
- 链接和图片路径；
- 脚注和引用；
- 任何不属于核心格式的 Markdown 扩展。

如果要投稿到 LaTeX 期刊，请直接使用 [Markdown 转 LaTeX](/docs/tools/markdown-to-latex/)。如果需要反向转换，请使用 [Typst 转 Markdown](/docs/tools/typst-to-markdown/)。如果想从空白的 Typst 工作区开始，请先看[可视化 Typst 编辑器](/docs/tools/visual-typst-editor/)或 [Typst 编辑器](/docs/tools/typst-editor/)。