UOS安装使用Typora高级导出功能

作为一位长期与各种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`，那个东西4个G的包，下载下来得装半天。我们装个轻量级的，够用就行： `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本身。启动它，点「文件」→「偏好设置」→「导出」。 1. 把「使用Pandoc导出」这个选项勾上。 2. 在「PDF导出设置」里，点那个「编辑自定义CSS」按钮，把下面这段代码贴进去，作用是开启带页码的页眉： ```css @media print { @page { @top-center { content: "第 " counter(page) " 页"; } } } ``` 回到编辑界面，确保你写满了三级标题（`### 三级标题`），再导出PDF，你就会发现它自动生成了带页码的页眉和可点击的书签目录。 导出Word时，有个小坑要注意：如果表格边框不见了，那八成是因为「导出」设置里的「简化HTML输出」选项被勾上了。这个选项会去掉表格的`border`属性，导致Pandoc在转成docx时丢失样式，把它关掉就好了。