帮助中心
关于撰写、编译和协作 LaTeX 与 Typst 项目的清晰实用指南。
用 Markdown 写作
以源码或排好格式的文字编辑 .md 文件,实时预览,并转换成 LaTeX 或 Typst。
在源码和可视化之间切换
Markdown 文件(.md 或 .markdown)的同一份文字有两种视图:「源码」按你输入的样子显示 Markdown,「可视化」在你编辑时就显示排好的格式。
操作步骤
- 打开一个 Markdown 文件,它会以「源码」打开。
- 点标签页下方工具栏开头的「源码 / 可视化」切换按钮,或在命令面板里运行「Markdown:切换到可视化编辑器」。再点一次即可切回。
- 在「可视化」里,标题、列表、表格、图片和公式都按阅读时的样子显示。把光标放进公式里就能编辑它的源码,下方会显示「公式预览」。
- 选中图片会出现「编辑图片」(可修改「路径或网址」和「替代文字」,再点「应用」)和「删除图片」。把指针移到链接上会出现「打开链接」和「移除链接」。
- 在「可视化」里选中文字,可以「添加评论」「添加到聊天」或「快速编辑」。协作者的编辑、评论和修订在两种视图里都会显示。
- 两种视图共用同一个光标,切换后仍停在原处。视图按标签页分别选择。
用工具栏排版
在 Markdown 标签页上,工具栏插入的是 Markdown,按钮在「源码」和「可视化」里效果相同。
操作步骤
- 「源码 / 可视化」切换按钮之后依次是撤销、重做、「标题层级」(1 到 6 级)、「粗体」「斜体」「行内代码」「插入链接」「插入脚注」「插入列表」「插入图片」「插入表格」「插入对齐公式」「插入行间公式」和「插入分数」。放不下的按钮会收进末尾的「更多 Markdown 操作」。
- 在段落或标题上选择「标题层级」会设置它的级别;在其他位置则插入一个新标题。
- 「插入列表」提供「无序列表」和「有序列表」,「插入表格」可以选择行列数。
- Markdown 没有下划线、引用和交叉引用,所以 Markdown 标签页上不显示这些按钮。
- 右键点工具栏,选择「隐藏文本工具栏」可以隐藏排版按钮,「源码 / 可视化」切换按钮仍会保留;在编辑器设置里打开「文本工具栏」即可恢复。
预览 Markdown 文件
预览会在你和协作者输入时直接渲染文件,不需要编译。
操作步骤
- 在 Markdown 标签页的标签栏里点「预览」,或按 Ctrl+K 再按 V(Mac 上是 ⌘K 再按 V)。预览会在源码旁边打开。
- 它能显示表格、任务列表、脚注、用 $ 和 $$ 写的数学公式、Mermaid 图,并把 > [!NOTE] 这样的提示显示为醒目的提示框。YAML 前置元数据不显示,文件里的 HTML 也不显示。
- 图片可以是项目里的文件(按相对于 Markdown 文件的路径),也可以是 https 地址。指向项目里另一个文件的链接会打开那个文件。
- 滚动源码时预览会跟着走。双击某个块,或按住 Ctrl(Mac 上是 Cmd)点击它,即可跳到源码里对应的行。
- 右键点预览,可以选择「跳转到源码」和「打开源文件」。
导入与导出 Markdown
Markdown 可以转换成 LaTeX 或 Typst,LaTeX 或 Typst 项目也可以导出为 Markdown。
操作步骤
- 要从 Markdown 草稿新建项目,点开「新建项目」旁边的箭头,选择「从文件导入」,选中 .md 文件,选好 LaTeX 或 Typst,再点「开始导入」。
- 在项目里,右键资源管理器中的 .md 文件,选择「转换为 LaTeX」(Typst 项目里是「转换为 Typst」),结果会写在它旁边。
- 要得到项目的 Markdown 副本,点标题栏上的 •••「项目操作」按钮,在「导出」下选择「Markdown (.md)」。公式保留为 TeX,图片放在正文旁边的文件夹里。
- 个人笔记也是 Markdown:在不含图片的页面上选择「下载」,会保存它的 .md 文件。
