$ guide / 中文教程

安装后，立即开始写作。

Paperling 是本地优先的 Markdown 编辑器。下载、安装或直接运行后，按 Ctrl + O 打开 Markdown 文件即可开始。

下载最新版

所有安装包均在 GitHub Release 发布。请只从官方 Release 页面下载。

打开 Release 下载页

Windows 10 / 11

下载 .msi 或 -setup.exe，双击并按提示完成安装。
不希望安装时，下载 -portable.exe；它不写入安装目录，双击即可运行。
首次被 SmartScreen 提示时，核对发布者与下载来源后选择“更多信息 → 仍要运行”。

macOS

下载对应架构的 .dmg，打开后将 Paperling 拖入“应用程序”。
首次打开若被 Gatekeeper 拦截，请在 Finder 中按住 Control 点击应用，选择“打开”。
以后可从“应用程序”或 Spotlight 启动。

Linux

Debian / Ubuntu

sudo apt install ./Paperling_*.deb

Fedora / RHEL

sudo dnf install ./Paperling-*.rpm

通用 AppImage（免安装）

chmod +x Paperling_*.AppImage
./Paperling_*.AppImage

第一次使用

打开文件：Ctrl + O；使用分屏模式同时编辑和预览。
命令面板：Ctrl + P 搜索功能、文件和标题。
帮助：按 ? 查看完整快捷键；设置中的“关于”可查看版本。
AI：在“设置 → AI”配置兼容 OpenAI 的服务；密钥存储在操作系统钥匙串。

更新、卸载与求助

下载新版安装包覆盖安装即可；Windows Portable 与 AppImage 只需替换旧文件。遇到问题时，请附上系统版本、Paperling 版本和复现步骤，在 GitHub 提交 Issue。