帮助中心

关于撰写、编译和协作 LaTeX 与 Typst 项目的清晰实用指南。

用 Markdown 写作

以源码或排好格式的文字编辑 .md 文件,实时预览,并转换成 LaTeX 或 Typst。

在源码和可视化之间切换

Markdown 文件(.md 或 .markdown)的同一份文字有两种视图:「源码」按你输入的样子显示 Markdown,「可视化」在你编辑时就显示排好的格式。

操作步骤

  1. 打开一个 Markdown 文件,它会以「源码」打开。
  2. 点标签页下方工具栏开头的「源码 / 可视化」切换按钮,或在命令面板里运行「Markdown:切换到可视化编辑器」。再点一次即可切回。
  3. 在「可视化」里,标题、列表、表格、图片和公式都按阅读时的样子显示。把光标放进公式里就能编辑它的源码,下方会显示「公式预览」。
  4. 选中图片会出现「编辑图片」(可修改「路径或网址」和「替代文字」,再点「应用」)和「删除图片」。把指针移到链接上会出现「打开链接」和「移除链接」。
  5. 在「可视化」里选中文字,可以「添加评论」「添加到聊天」或「快速编辑」。协作者的编辑、评论和修订在两种视图里都会显示。
  6. 两种视图共用同一个光标,切换后仍停在原处。视图按标签页分别选择。

用工具栏排版

在 Markdown 标签页上,工具栏插入的是 Markdown,按钮在「源码」和「可视化」里效果相同。

操作步骤

  1. 「源码 / 可视化」切换按钮之后依次是撤销、重做、「标题层级」(1 到 6 级)、「粗体」「斜体」「行内代码」「插入链接」「插入脚注」「插入列表」「插入图片」「插入表格」「插入对齐公式」「插入行间公式」和「插入分数」。放不下的按钮会收进末尾的「更多 Markdown 操作」。
  2. 在段落或标题上选择「标题层级」会设置它的级别;在其他位置则插入一个新标题。
  3. 「插入列表」提供「无序列表」和「有序列表」,「插入表格」可以选择行列数。
  4. Markdown 没有下划线、引用和交叉引用,所以 Markdown 标签页上不显示这些按钮。
  5. 右键点工具栏,选择「隐藏文本工具栏」可以隐藏排版按钮,「源码 / 可视化」切换按钮仍会保留;在编辑器设置里打开「文本工具栏」即可恢复。

预览 Markdown 文件

预览会在你和协作者输入时直接渲染文件,不需要编译。

操作步骤

  1. 在 Markdown 标签页的标签栏里点「预览」,或按 Ctrl+K 再按 V(Mac 上是 ⌘K 再按 V)。预览会在源码旁边打开。
  2. 它能显示表格、任务列表、脚注、用 $ 和 $$ 写的数学公式、Mermaid 图,并把 > [!NOTE] 这样的提示显示为醒目的提示框。YAML 前置元数据不显示,文件里的 HTML 也不显示。
  3. 图片可以是项目里的文件(按相对于 Markdown 文件的路径),也可以是 https 地址。指向项目里另一个文件的链接会打开那个文件。
  4. 滚动源码时预览会跟着走。双击某个块,或按住 Ctrl(Mac 上是 Cmd)点击它,即可跳到源码里对应的行。
  5. 右键点预览,可以选择「跳转到源码」和「打开源文件」。

导入与导出 Markdown

Markdown 可以转换成 LaTeX 或 Typst,LaTeX 或 Typst 项目也可以导出为 Markdown。

操作步骤

  1. 要从 Markdown 草稿新建项目,点开「新建项目」旁边的箭头,选择「从文件导入」,选中 .md 文件,选好 LaTeX 或 Typst,再点「开始导入」。
  2. 在项目里,右键资源管理器中的 .md 文件,选择「转换为 LaTeX」(Typst 项目里是「转换为 Typst」),结果会写在它旁边。
  3. 要得到项目的 Markdown 副本,点标题栏上的 •••「项目操作」按钮,在「导出」下选择「Markdown (.md)」。公式保留为 TeX,图片放在正文旁边的文件夹里。
  4. 个人笔记也是 Markdown:在不含图片的页面上选择「下载」,会保存它的 .md 文件。
问题、缺陷与建议在 JointTex 论坛向社区提问、报告问题,或为功能建议投票。
账户、账单或隐私问题?有关账户、订阅或个人数据的事项,请发送邮件给我们的支持团队。
[email protected]
JointTex

Browser compatibility

JointTex could not start

The application did not finish loading. Check your connection, then try again.

Supported versions

  • Chrome and Edge 88 or later
  • Firefox 84 or later
  • Safari and iOS Safari 14 or later
Reload