企业官网建设流程全解析

Zettlr完整新手指南：5步搞定Markdown写作、双向链接与引用导出

【免费下载链接】ZettlrYour One-Stop Publication Workbench项目地址: https://gitcode.com/GitHub_Trending/ze/Zettlr

你正在给一篇论文排版：正文写好了，参考文献还没插、格式又对不上学校要求。这类"写完再折腾"的活儿，Zettlr想替你省掉——它把Markdown写作、笔记双向链接、学术引用和一键导出放在同一个知识管理工作台里。下面按你要完成的任务来讲，每步都能直接照着做。

上手：5分钟把Zettlr跑起来

装好Zettlr你有两条路，二选一即可。

• 预编译版：从项目仓库 https://gitcode.com/GitHub_Trending/ze/Zettlr 的发布页下载对应系统（Windows / macOS / Linux，均64位）的安装包，双击安装。
• 源码构建：先装好Node.js和Yarn，然后克隆并启动开发版：

git clone https://gitcode.com/GitHub_Trending/ze/Zettlr cd Zettlr yarn install yarn start

装完后打开它，按Cmd/Ctrl+O选一个本地文件夹作为工作区——Zettlr不上传任何内容，你的笔记就是那文件夹里的Markdown文件。主界面分三块：左侧文件管理器、中央编辑器、右侧边栏；右侧边栏有目录、引用、相关文件、附件四个标签，点顶部工具栏那个柱状图图标可以收起或展开它。

依赖的Pandoc是导出功能的底层工具，仓库里的 scripts/get-pandoc.sh 脚本会自动下载安装它；所有依赖和构建脚本都写在 package.json 里，想看构建细节查这里。

把笔记连成网：链接、标签与搜索

给笔记生成唯一ID

在编辑区按Cmd/Ctrl+L，当前笔记就会拿到一个唯一文件ID。之后不管文件名怎么改，用[[ID]]都能稳定引用到它，适合长期积累的卡片盒笔记（Zettelkasten）。

内部链接与反向链接

输入[[文件名]]建立笔记之间的链接，光标停在链接上按Cmd/Ctrl再点一下即可跳转。想知道"谁引用了我"：打开右侧边栏的"相关文件"标签，所有引用当前笔记的文件都列在那里，这就是反向链接。

用标签归类，用搜索定位

正文里写#标签名就打上了标签；点工具栏的标签图标进入标签管理器，可以批量重命名、给标签设颜色。找东西时按Cmd/Ctrl+F打开搜索面板，它支持正则表达式，比如#TODO能捞出所有待办。

想深入可以看这里：

• 工作区与链接数据流：source/pinia/workspace-store.ts
• 标签状态管理：source/pinia/tags-store.ts

写出带引用的论文：从文献库到字数统计

导入参考文献

在"文件 > 导入"里选择BibTeX文件，或者直接把它拖进工作区文件夹，Zettlr就会识别你的文献库（也兼容Zotero、JabRef等参考管理器的导出格式）。

插入引用

写作时输入@会触发引用建议，选中某条文献后自动生成引用标记。导出时选哪种引用样式（如APA、Chicago），在"设置 > 导出"里挑一个CSL样式即可。

边写边看：字数与番茄钟

底部状态栏实时显示当前文档字数；完整的写作统计在"工具 > 统计"里查看。想专注写作时，可以启用内置的Pomodoro番茄计时器，在设置里配置时长。

想深入可以看这里：

• 字数统计实现：source/pinia/statistics-store.ts
• 番茄钟状态管理：source/pinia/pomodoro-store.ts

一键导出成品：格式怎么选

点工具栏上那个箭头向外的导出按钮，选择输出格式和保存路径，就能得到PDF、DOCX、HTML、LaTeX等成品——底层是Pandoc，格式模板对应仓库 static/defaults/ 下的一组YAML配置（如XeLaTeX PDF.yaml、Microsoft Word.yaml），改这些文件就能批量调整默认导出行为。

想调更细的参数（页面大小、字体、模板），在导出弹窗的高级设置里改；写演讲材料时，仓库还附了一个Reveal.js演示模板 scripts/assets/reveal-template.htm 可以直接套用。

引用样式的清单维护在 static/csl-styles/，目前内置Chicago等格式，社区会持续补充。

把界面改成自己的样子

在"偏好设置 > 外观"里可以切换主题（含深色模式）、更换字体、调整代码高亮样式。还不够就加自定义CSS：在"设置 > 高级 > 自定义CSS"里贴入样式代码，编辑器、预览、状态栏都能被你的CSS覆盖。

想深入可以看这里：自定义CSS窗口的完整实现（含预览与过滤逻辑）在 source/win-assets/CustomCSS.vue，照着它的字段就能确认你的CSS作用于哪些区域。

避坑与常见问题

⚠️ 这几条能帮你少走弯路：

• 工作区就是普通文件夹：定期备份它，等于备份了全部笔记；Zettlr不做云端同步，文件本地存放是特性不是缺陷。
• 导出长期存档选PDF/A：普通PDF依赖生成环境，PDF/A保证多年后还能正常打开。
• 没有Pandoc就没有导出：源码构建或精简系统上，先确认Pandoc可用（见 scripts/get-pandoc.sh），否则导出会直接失败。
• 只支持64位：官方提供Intel与ARM（Apple Silicon）的64位包，没有32位版本；选安装包时按CPU架构挑，装错架构会打不开。

下一步的3个动作

1. 改一个导出模板：从 static/defaults/ 复制一份YAML，改好再在导出弹窗里选用，把页面、字体固定成你自己的格式。
2. 开多工作区：用"文件 > 新建窗口"同时挂不同项目（论文、博客、卡片盒各一个），互不干扰。
3. 接上命令行自动化：scripts/ 目录下的脚本可以纳入你的日常流程；想给Zettlr加自定义服务能力，可以从 source/app/service-providers/ 的结构入手。

想继续看文档的话，官方教程在 static/tutorial/en/，其中 LaTeX Guide.md 专讲模板排版、citing.md 专讲引用，配合上面的三个动作正好用完。

【免费下载链接】ZettlrYour One-Stop Publication Workbench项目地址: https://gitcode.com/GitHub_Trending/ze/Zettlr