推荐三款真正适配统信UOS的Markdown编辑器:应用商店版Typora(预置UKUI主题与中文字体,开箱即用)、Joplin AppImage(需手动禁用硬件加速,适合加密博客)、系统自带Dedit(轻量预览,不支持元数据);安装后必须配置QT_QPA_PLATFORMTHEME=ukui及文泉驿字体,否则中文显示为方块、右键失效。

在统信UOS上用Markdown编辑器写博客和笔记,需先选对工具、配好中文字体与渲染环境,再建立符合静态站点或知识库逻辑的文件结构,否则新建的.md文件可能无法预览、中文显示为方块、标题不生效,甚至同步时丢失元数据。
选一款真正适配UOS的Markdown编辑器
别直接装官网通用版——UOS桌面环境(UKUI)对Qt/Electron应用有特殊要求,装错会导致右键菜单消失、托盘图标不响应、中文输入法卡顿。优先按顺序尝试:
方法一:用应用商店安装Typora(最省心)
打开UOS【应用商店】→顶部搜索框输入“Typora”→认准开发者为“Typora Inc.”且标注“UOS适配版”的条目→点击【安装】→完成后从开始菜单启动。此版本已预置UKUI主题补丁、fonts-wqy-microhei字体及禁用GPU加速策略,跳过全部手动配置。
方法二:手动部署Joplin AppImage(适合需端到端加密的博客作者)
去Joplin GitHub Releases页下载Joplin-*.AppImage →右键→属性→勾选“允许作为程序执行”→双击运行→首次启动时指定仓库路径为/home/你的用户名/Documents/JoplinBlog。注意:必须进入设置→外观→关闭“硬件加速”,否则UOS下极易白屏。
方法三:启用系统自带Dedit(仅限快速记事,不支持博客元数据)
在开始菜单搜索“Dedit”并打开→新建文件→保存为note.md→输入# 标题后按Ctrl+Enter,若标题变大即渲染正常。但Dedit不支持YAML Front Matter、无导出PDF功能,仅作临时笔记用。
配置中文字体与实时渲染环境
这一步漏掉,所有中文将显示为□□□,且Ctrl+Enter无法触发Markdown渲染。
打开终端,依次执行:
sudo apt install fonts-wqy-microhei fonts-noto-cjk -y →安装文泉驿微米黑与思源黑体
echo 'export QT_QPA_PLATFORMTHEME=ukui' >> ~/.bashrc && source ~/.bashrc →让Typora识别UOS系统级右键菜单与托盘
重启Typora,在「文件→偏好设置→外观」中,将默认字体设为【WenQuanYi Micro Hei】,字号调至14px以上。
验证是否生效:新建笔记,输入
# 博客标题
## 二级标题
- 列表项1
- 列表项2
然后按Ctrl+Enter——若标题加粗放大、列表缩进正确、中文无方块,说明配置完成。
搭建博客专用文件结构(以Zola+Typora组合为例)
Zola是UOS下最轻量稳定的静态博客生成器,配合Typora写作,能实现“写完即发布”。它不要数据库、不依赖PHP,生成的全是HTML文件,可直接扔进Nginx或UOS自带Web服务器。
第一步:安装Zola
终端执行:
curl -L https://github.com/getzola/zola/releases/download/v0.19.4/zola_0.19.4_x86_64-unknown-linux-gnu.tar.gz | tar xz →下载二进制
sudo mv zola /usr/local/bin/ →移入系统路径
zola --version →确认输出zola 0.19.4
第二步:初始化博客项目
mkdir -p ~/Blog && cd ~/Blog
zola init myblog →全程回车用默认设置,除“是否启用语法高亮”选y
第三步:在Typora中绑定content/posts目录
打开Typora → 文件→打开文件夹→选择~/Blog/myblog/content/posts
新建笔记 →保存为2026-10-28-我的第一篇博客.md
第四步:写带YAML元数据的博客正文
在文件开头插入(顶格,前后空行):
+++
title = "我的第一篇博客"
date = 2026-10-28
draft = false
+++
# 正文从此开始
这里是第一段……
Ctrl+Enter实时看效果。
第五步:本地预览与生成
终端回到~/Blog/myblog目录→执行zola serve →浏览器打开http://127.0.0.1:1111
修改Typora中的.md文件→保存→网页自动刷新更新。
用Obsidian构建笔记知识库(适合长期积累)
Obsidian把每个.md文件当独立节点,靠内部链接和图谱形成知识网络,比单篇博客更适合做技术笔记沉淀。
下载Obsidian-*.AppImage →右键→属性→勾选“允许作为程序执行”
双击运行→首次启动时指定仓库路径为/home/你的用户名/Documents/ObsidianNotes
在设置中启用插件:“文件夹视图”、“大纲”、“日历”
新建笔记命名为UOS-Markdown写作指南.md,输入:
# UOS-Markdown写作指南
## 安装步骤
- [x] Typora已配置UKUI主题
- [ ] Zola本地预览未成功 →点击此项可跳转到另一篇叫“Zola调试日志.md”的笔记
注意:【所有笔记必须保存在Obsidian指定的仓库根目录内,跨文件夹链接会失效】。写完后右键→“在文件管理器中显示”,即可用UOS默认文件管理器直接拖拽备份整个文件夹。


















