Keldos-Li/typora-latex-theme · 上手攻略

  • 仓库：Keldos-Li/typora-latex-theme
  • 链接：https://github.com/Keldos-Li/typora-latex-theme
  • 分类：academic-writing
  • 作者：Jay
  • 更新：2026-07-15

这是什么

typora-latex-theme 是一个让 Typora 编辑器渲染出类 LaTeX 排版外观的 CSS 主题。它的核心价值是：让你用 Markdown 的轻量语法写作，但导出 PDF 时呈现正经的学术论文样式——字体、段落、标题、公式、表格、参考文献，都按 LaTeX 风格来。

预设样式参考了浙江大学本科课程论文格式（小字体、小页边距），但所有格式参数都暴露在 CSS 变量里，用户可以自行修改成自己学校的模板。

解决什么问题

  • 不用装 LaTeX 环境就能输出"看起来像 LaTeX 排版"的 PDF
  • 写论文不用每次手动调格式，专注内容，导出即可
  • 支持中文论文，支持封面、目录、公式、表格、代码高亮、Mermaid 图形
  • 跨平台（Windows、macOS、Linux 上的 Typora 通用）

快速安装

第一步：确认已安装 Typora

从 https://typora.io/#download 下载并安装 Typora（正式版已收费，测试版或历史版本可自行查找）。

第二步：下载主题包

前往 GitHub Releases 页面： https://github.com/Keldos-Li/typora-latex-theme/releases/latest

根据操作系统下载对应压缩包： - latex-theme-windows.zip（Windows） - latex-theme-mac.zip（macOS） - latex-theme-linux.tar.gz（Linux）

第三步：安装主题

解压缩后，进入解压目录，用 Typora 打开其中的 README.md，按步骤进行手动或自动主题安装。简要步骤如下：

方法 A：自动安装（推荐） 运行解压目录中的安装脚本（Windows 为 .ps1，macOS/Linux 为 shell 脚本）。

方法 B：手动安装

# 将解压出的 CSS 文件复制到 Typora 主题目录
# macOS: ~/Library/Application Support/abnerworks.Typora/themes/
# Windows: %APPDATA%\Typora\themes\
# Linux: ~/.config/Typora/themes/
cp -r ./latex/ ~/.config/Typora/themes/

第四步：安装所需字体

⚠️ 这一步经常被忽略，导致 PDF 导出版本字体不对。

主题依赖特定字体（通常是方正系列或其他中文论文常用字体）。如果导出后发现字体缺失，在 Typora 中打开"字体"设置，安装解压目录中提供的字体文件，或者在主题 CSS 文件的 @font-face 部分自行替换为系统已有的字体。

第五步：启用主题

打开 Typora → 菜单栏 → 主题 → 选择 LaTeX（或解压包中标注的主题名称）。

核心用法

写作与导出

用 Markdown 语法写作，示例：

---
title: 《课程论文标题》
author: 你的名字
date: 2026年7月
---

# 第一章 引言

这里是正文。引用文献示例 [@Smith2024]。

# 第二章 方法

## 2.1 实验设计

$$E = mc^2 \tag{1}$$

| OS | Windows | macOS | Linux |
|----|---------|-------|-------|
| 中国 | 87.55 | 5.44 | 0.75 |

# 参考文献

[^1]: Smith, J. (2024). *Title*. Journal.

导出 PDF：菜单 → 文件 → 导出 → PDF，或直接 Ctrl/Cmd + P。

公式支持

Typora 原生支持 LaTeX 公式语法，行内公式用 $...$，独立公式块用 $$...$$：

$$
\iint\limits_{x^2 + y^2 \leq R^2} f(x,y)\,\mathrm{d}x\,\mathrm{d}y
= \int_{\theta=0}^{2\pi} \mathrm{d}\theta\int_{r=0}^R f(r\cos\theta,r\sin\theta) r\,\mathrm{d}r
$$

Mermaid 图形

主题支持在 Typora 内预览 Mermaid 图形（需 Typora 版本支持，或导出后渲染）：

```mermaid
graph LR
A(开始) --> B{判断}
B -->|yes| C[结果]
B -->|no| D[另一个结果]
```

个性化修改（换学校模板）

打开解压目录中的 latex.css，修改最前面约 70 行的 CSS 变量：

:root {
  /* 字体设置 */
  --font-family-body: "Times New Roman", "FangSong", serif;
  --font-family-cjk: "FangSong", "SimSun", serif;

  /* 字号设置 */
  --font-size-body: 12pt;  /* 正文字号，默认较小（适配浙大格式） */
  --font-size-heading1: 16pt;
  --font-size-heading2: 14pt;

  /* 页边距 */
  --page-margin-top: 2.5cm;
  --page-margin-bottom: 2.5cm;
  --page-margin-left: 3cm;
  --page-margin-right: 3cm;

  /* 行距 */
  --line-height: 1.5;
}

封面模板

解压目录通常包含一个封面模板文件，使用时直接替换个人信息即可。

典型适用场景

  1. 本科生课程论文 / 小型实验报告：应付通识课作业，格式要求不高但需要看起来正式。
  2. 中文 LaTeX 入门过渡：先在这个主题下习惯 Markdown 写作，了解 LaTeX 的逻辑结构，再过渡到真正的 LaTeX 环境。
  3. 快速输出会议 poster 或短报告：不需要复杂的 LaTeX 编译链，随时修改随时导出。
  4. 需要中英文混排的简短报告：Typora 对双语写作支持较好，CSS 主题可以控制中英文字体混合。

坑与注意

  1. Typora 已收费：正式版 Typora 现在需要购买许可（68 元左右一次性买断），免费版已不可用。如需免费方案，可寻找历史测试版本，但需自行承担风险。
  2. CSS 热更新问题：主题安装后不支持热更新。如果已经做过个性化修改，升级主题会覆盖你的 CSS，建议备份自定义 CSS 文件（重命名为 latex-custom.css 等）。
  3. 字体是最常见问题：导出 PDF 字体不对 90% 是因为字体未安装或字体路径错误。检查 --font-family-* 变量中引用的字体是否已在系统中安装。
  4. 页码和目录：Typora 导出 PDF 时目录（TOC）需要手动插入 [toc] 指令，页码由 PDF 渲染器决定，CSS 主题不控制这些。
  5. 平台一致性：macOS 和 Windows 对同一 CSS 字体渲染略有差异，同一文件在不同平台导出的 PDF 视觉效果可能有细微差别。
  6. 非真正的 LaTeX：这是 CSS 模拟 LaTeX 外观，不是真正的 LaTeX 编译器。如果你需要 LaTeX 的交叉引用、浮动体精确排版等功能，这个主题做不到。
  7. 中文标点：CSS 中硬编码了一些中文标点样式，建议在个性化设置中检查是否需要调整 quotes 和 punctuation 相关变量。

与同类对比

特性 typora-latex-theme 真正 LaTeX (Overleaf/XeLaTeX) Word 模板
学习成本 低（Markdown） 高（LaTeX 语法） 中
排版质量 中（CSS 模拟） 高（编译级） 中
表格/公式/交叉引用 部分支持 完整支持 完整支持
安装难度 低（装 Typora 即可） 高（TeX 发行版） 低
中文支持 ✅ 好 ✅ 需配置 ✅
适合人群 课程论文、快速报告 正式学术论文 通用办公

一句话总结：如果你不需要 LaTeX 的全部高级功能，只是想写一篇格式看起来正经的中文课程论文，typora-latex-theme 是一个比真正装 LaTeX 省事 10 倍的选择。

一句话推荐

用 Markdown 写，用 LaTeX 的脸出版——本科生应付课程论文或快速输出中文报告，typora-latex-theme 是目前最简单且开源的方案。