快速入门
CiteDesk 是一个 Markdown 编辑器加文献管理器：写作、引用和阅读在同一个应用里完成。本页带您走完第一次使用的过程。
CiteDesk 是什么
- 正文是 Markdown 文件。 文件保存在您打开的工作区文件夹里，用别的 Markdown 工具也能读。文档里只存您写的字和 CiteDesk 的标记，不存排好的版面。
- 文献在文献库里。 文献库是应用数据目录里的一个数据库，所有文档共用。每条文献都是标准的 CSL-JSON，可以和 Zotero 等工具互相导入导出。
- 引用是正文里的标记。 引用写成
[@…@]，注释写成[@?@]…[@/?@]，详见引用与注释。 - 版面由样式决定。 正文里的引用、脚注和参考文献表都由 CSL 样式排出，换一个样式整篇文档随之改变。
- 成稿是另一份文件。 写完之后用「导出成稿」生成 Word、PDF、HTML 或 Markdown，见导出成稿。
界面
- 左栏 是文件列表和大纲，另有在整个工作区里搜索的页。用 文件 > 打开文件夹… 选一个文件夹作为工作区。
- 中间 是文档标签，每个标签里是一篇 Markdown 文档的实时预览；用 视图 > 切换实时预览/源码模式 在预览和源码之间切换。
- 右栏 是写作侧栏「引注工作台」：列出当前文档的引用和注释，可以搜索文献、插入引用、更改文档首选项和导出成稿。
- 文献库 默认是一扇独立的窗口，相当于 Zotero 的主窗口，可以放到另一块屏幕上和写作窗口并用。用 视图 > 打开文献库 打开它；在主窗口中以标签打开文献库 把它收进写作窗口里。同一时间只有一个文献库界面。
- 设置 在 设置…（macOS 在应用菜单里，其他系统在文件菜单里）。各页的说明见设置。
建立文献库
文献可以这样加进来：
- 在文献库窗口里新建一条文献，手工填写；
- 通过标识符添加：输入 DOI、ISBN、arXiv 号或 PubMed 号，见按标识符添加；
- 用浏览窗口打开一个网页，按「保存到文献库」；
- 用 文件 > 导入… 导入 BibTeX、RIS、CSL-JSON 等文件，见导入与导出文献；
- 把 PDF 添加成附件，应用会尝试检索元数据建出文献。
文献库的使用方法见文献库。
写第一条引用
- 打开或新建一篇 Markdown 文档（文件 > 新建笔记）。
- 把光标放在要引用的位置，选 插入 > 引用。
- 在对话框里搜索文献并选中；需要时填写页码等定位符；确认。
- 正文里出现
[@…@]标记，实时预览里它显示成样式排出的引用文字。 - 在右栏点文档卡片上的 更换，选择参考文献样式和排版语言，见文档首选项。
粘贴和拖入图片与文件
- 在 Markdown 编辑器里粘贴截图或复制的图片，或者把文件拖进正文，文件会复制到设置里「附件默认存放路径」指定的文件夹，并在光标处写入嵌入它的链接，例如
![[Pasted image 20261021153045.png]]。截图这类没有名字的图片叫「Pasted image」加上日期时间，同名文件自动加序号。 - 文件本来就在工作区里时不复制，直接嵌入它。
- 拖入时按住 Option（macOS）或 Ctrl（其他系统）只插链接、不复制：工作区里的文件写它的链接，工作区外的文件写指向它的
file:///链接。 - 链接的写法认设置里的「新链接格式」和「使用 Wiki 链接」。
- 一次粘贴或拖入是一步编辑。撤销只撤销正文，已经复制的文件仍留在工作区里。
- 单个文件不能超过 64 MiB，文件夹不能直接拖入。
- 从文献库的文献表里把附件拖进正文：附件文件本来就在工作区里（链接的文件）时写文件链接；否则写它所属文献的引用标记；没有所属文献的独立附件按普通文件复制。
导出
写完之后选 文件 > 导出成稿…，在窗口里选格式：Word、PDF、HTML 或 Markdown。成稿里的脚注和参考文献表是排好的真内容。详见导出成稿。