IceEnd/Yosoro · 上手攻略

• 仓库：IceEnd/Yosoro
• 链接：https://github.com/IceEnd/Yosoro
• 分类：academic-writing
• 作者：Tom
• 更新：2026-08-14

是什么

Yosoro 是一款面向 macOS、Windows 和 Linux 的云同步 Markdown 笔记本桌面应用，主打高颜值界面与 OneDrive 云同步能力，支持 LaTeX 数学公式、绘图（流程图、时序图等）、图片上传（GitHub/微博/SM.MS）、Markdown 导出（PDF/HTML/MD）和一键发布到 Medium。界面提供暗色（Moon）与亮色（Light）双主题，设计风格清新简洁。

解决什么问题

• 需要一个好看且支持 Markdown 的本地笔记应用
• 想把笔记同步到云端（目前支持 OneDrive）避免本地丢失
• 写学术笔记时需要LaTeX 公式和图表支持
• 希望直接发布博客文章到 Medium 等平台
• 需要图床功能，把截图直接上传到公开 CDN

快速安装

方式一：下载预编译包（推荐）

前往 GitHub Releases 页面，下载对应平台的最新安装包：

⚠️ 由于项目维护不活跃，预编译版本可能未更新到最新功能。如遇问题可从源码构建。

方式二：源码构建

前置依赖

# 需要 Node.js（建议 v16+）和 yarn
node --version   # 确认已安装
npm install -g yarn

构建步骤

# 1. 克隆仓库
git clone https://github.com/IceEnd/Yosoro.git
cd Yosoro

# 2. 安装依赖
yarn
# Windows 用户如遇安装失败，尝试：
yarn --ignore-platform

# 3. 开发模式运行（可选）
yarn dev:main      # 主进程
yarn dev:renderer  # 渲染进程
# 两个终端分别执行，即可开发调试

# 4. 打包全平台安装包
yarn build:all

# 5. 单独打包指定平台
yarn packager:mac    # macOS
yarn packager:win     # Windows 32位
yarn packager:win:64  # Windows 64位
yarn packager:linux   # Linux

配置 OneDrive 云同步

# 1. 复制配置示例文件
cp ./config/devconfig.example.json ./config/devconfig.json

# 2. 编辑 devconfig.json，添加 OneDrive 授权路径
# （具体授权方式需在应用内 UI 完成，此处仅配置文件准备）

OneDrive 同步功能需在应用内登录 Microsoft 账户完成授权。

核心用法

笔记管理

• 新建笔记：左侧边栏点击「+」创建新笔记
• 文件夹管理：支持多级文件夹结构组织笔记
• 搜索：支持按标题和内容全文搜索笔记

LaTeX 数学公式

Yosoro 内置 LaTeX 渲染，支持行内公式和独立公式块：

行内公式：这是一元二次方程 $x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$

独立公式：
$$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

公式会在编辑界面实时渲染预览。

绘图支持

支持 Mermaid、PlantUML 等常见图表语法：

```mermaid
sequenceDiagram
    A->>B: 请求
    B-->>A: 响应
```

图片上传（图床）

内置多平台图床支持，截图后可直接粘贴上传：

上传后的图片自动替换为 Markdown 图片语法，可直接用于博客。

导出与发布

• 导出格式：Markdown、HTML、PDF
• 直接发布：支持一键发布文章到 Medium（需配置 Medium API）

主题切换

工具栏提供暗色/亮色主题一键切换。

典型适用场景

• 个人知识管理：用 Markdown 结构化整理读书笔记、学习笔记
• 学术写作辅助：LaTeX 公式 + 云同步，适合在逃课或图书馆写数学笔记
• 博客写作工作流：Yosoro 写草稿 → 图床上传图片 → 导出 HTML/MD → 发布到博客平台
• 云端备份笔记：OneDrive 同步，走到哪里都能访问

坑与注意

⚠️ 项目维护状态堪忧

Yosoro 的 GitHub 活跃度较低，最近一次 commit 时间较早（建议自行查看仓库最新动态确认）。Electron 应用长期不更新可能存在： - 安全漏洞（Electron 版本过旧带来的Chromium 漏洞） - 兼容性问题（与新版 macOS/Windows 的兼容）

建议仅用于个人本地笔记，不要处理敏感内容。

⚠️ 云同步仅支持 OneDrive

如果需要其他云盘（iCloud、Dropbox、Google Drive）同步，需要手动用系统级同步工具（如 FreeFileSync）指向 Yosoro 的笔记存储目录，而非应用内置集成。

⚠️ 导出 PDF 样式有限

Yosoro 导出的 PDF 基于渲染后的 HTML，样式定制能力有限。如需高质量学术 PDF，建议从 Yosoro 导出 Markdown 后，用 VS Code + LaTeX 或 Pandoc 重新处理。

⚠️ Medium 发布需 API Token

直接发布到 Medium 需要在 Medium Settings 页面申请 Integration Token，并在应用内配置。

⚠️ 中文输入兼容

Electron 应用在部分 Linux 发行版上可能存在输入法（fcitx/rime）与输入框的兼容问题，症状为无法正常输入中文。建议 macOS / Windows 用户优先使用。

与同类对比

Yosoro 的差异化定位是云同步（OneDrive）+颜值 + LaTeX + 图床四合一，适合已经使用 OneDrive 且不需要复杂插件生态的用户。劣势在于维护不活跃和仅支持 OneDrive 一种云服务。

一句话推荐结论

Yosoro 是一个颜值党友好、支持 LaTeX 和 OneDrive 同步的轻量 Markdown 笔记应用，适合 OneDrive 用户快速搭建「写→存→发布」闭环，但请注意项目维护状态偏弱，建议重要笔记额外备份。