好的，作为一位长期深耕各类 Linux 发行版的老手，今天我来详细聊聊如何在 UOS 上激活 Typora 的高级导出功能。相比其他系统，这里有几个关键细节需要留意，尤其是在官方 APT 源已经停止更新的情况下，需要手动做一些适配。 要在 UOS 中让 Typora 既能顺畅写作，又能顺利导出包含目录、页眉页脚的 Word 或 PDF 文档，核心思路是绕过已经停更的官方 APT 源，自行搭建 Pandoc 和 LaTeX 运行环境。否则，当你点击“导出 → Word”时，只会收到“需要安装 Pandoc”的提示，并且操作就此中断。 ### 检查系统版本与基础依赖环境 第一步，先确认你的 UOS 版本是否达标。打开终端，运行 `uname -a`，确保内核版本不低于 5.10。接着，执行以下关键命令： `cat /etc/os-release | grep -E "(VERSION_CODENAME|NAME)"` 输出结果中必须包含 `VERSION_CODENAME=apricot` 或 `uos` 字样，这代表你的系统是 UOS 20 SP2 或更高版本。如果版本过低，Typora 1.8+ 基于 Electron 24 的内核可能无法正常运行。 之后，执行 `sudo apt update && sudo apt install curl wget gnupg2 software-properties-common -y`，补齐基础工具链。如果系统提示 `gnupg2` 找不到，直接使用 `gnupg` 即可，UOS 默认已预装。 ### 安装 Typora 1.8.10：最后一个免费且稳定的版本 这一步有两个主流方法，推荐优先采用第一种。 **方法一：通过国内镜像 APT 源安装（推荐）** 将以下命令逐条复制到终端并执行： ```bash curl -sSL https://typora.io/linux/public-key.asc | sudo gpg --dearmor -o /usr/share/keyrings/typora-linux-archive-keyring.gpg echo "deb [arch=amd64 signed-by=/usr/share/keyrings/typora-linux-archive-keyring.gpg] https://mirrors.tuna.tsinghua.edu.cn/typora/linux ./" | sudo tee /etc/apt/sources.list.d/typora.list sudo apt update sudo apt install typora=1.8.10-1 ``` **方法二：手动安装 DEB 包（备用方案）** 如果镜像源不可用，可以直接前往 GitHub 官方发布页下载 `typora_1.8.10_amd64.deb` 文件。假设文件保存在 `~/Downloads` 目录，则执行： ```bash cd ~/Downloads && sudo apt install ./typora_1.8.10_amd64.deb ``` **【重要提醒】**：无论采用哪种方式安装，安装完成后请立即执行以下命令，锁定当前版本，防止后续系统升级时被自动覆盖为收费版： ```bash sudo apt-mark hold typora ``` ### 配置 Pandoc：实现高级导出功能的核心 **第一步：安装 Pandoc** `sudo apt install pandoc pandoc-data haskell-platform -y` 安装完成后，运行 `pandoc --version` 检查版本号，确保不低于 `3.1.12`。如果版本过低，Typora 在处理复杂嵌套列表时可能会解析失败。 **第二步：安装轻量级 LaTeX 引擎** 不建议安装体积庞大的 `texlive-full`（约 4GB），我们安装轻量级版本，足以满足日常需求： `sudo apt install texlive-latex-base texlive-fonts-recommended texlive-latex-extra texlive-lang-chinese -y` 这套组合包安装后约占用 1.2GB 空间，但能够完美支持中文 PDF 的字体嵌入和目录生成。相比完整版，这一步可以为你节省至少 3 小时的安装时间。 **第三步：测试导出链路** 启动 Typora，新建一个文件，输入 `# 标题` 和 `## 子标题` 等内容，保存为 `test.md`。然后在终端中执行： `pandoc test.md -o test.docx --standalone` 如果成功生成 `test.docx` 并打开后能看到标题层级，说明 Pandoc 链路已打通。如果遇到报错 `Could not find data file templates/default.latex`，表示 LaTeX 模板未安装完整，再执行 `sudo tlmgr install collection-latex` 即可补充。UOS 自带 `tlmgr` 工具，无需额外配置。 ### 启用 Typora 内置的高级导出功能 现在配置 Typora 本身。启动 Typora，点击「文件」→「偏好设置」→「导出」。 1. 勾选「使用 Pandoc 导出」选项。 2. 在「PDF 导出设置」中，点击「编辑自定义 CSS」按钮，将以下代码粘贴进去，用于生成带页码的页眉： ```css @media print { @page { @top-center { content: "第 " counter(page) " 页"; } } } ``` 回到编辑界面，确保文档包含三级标题（`### 三级标题`），再次导出 PDF，你就会发现自动生成了带页码的页眉以及可点击的书签目录。 导出 Word 时有一个常见问题：如果表格边框消失，通常是因为「导出」设置中的「简化 HTML 输出」选项被勾选。该选项会移除表格的 `border` 属性，导致 Pandoc 在转换为 docx 时丢失样式。取消勾选即可恢复表格边框。