Zettlr 交互式入门教程welcome.md全解析工作区、Markdown、智能链接与侧边栏实战【免费下载链接】ZettlrYour One-Stop Publication Workbench项目地址: https://gitcode.com/GitHub_Trending/ze/Zettlr本指南以 Zettlr 官方入门教程日语版 static/tutorial/ja/welcome.md 为绝对主线逐节拆解这款「一站式出版工作台」One-Stop Publication Workbench的首次启动体验从工作区Workspace与文件管理器的三种模式到 Markdown 核心语法、智能链接、四页签侧边栏再到复选框与表格编辑等交互元素。同时结合仓库源码如 tutorial-open.ts 与 get-config-template.ts揭示教程背后的实现机制让读者既会「照着做」也理解「为什么这么做」从而真正掌握 Zettlr 的基础操作与底层配置原理。教程是什么一份可交互、可动手的 Markdown 文档Zettlr 与许多 Markdown 应用一样采用「交互式教程」的方式引导新用户上手。教程本身就是一个普通的 Markdown 文件位于仓库的 static/tutorial/ja/welcome.md文件头部带有 YAML frontmatter--- title: Zettlr へようこそ keywords: - Guide - Tutorial - Introduction ---frontmatter 中的title与keywords会被 Zettlr 用于文件元信息展示与检索。仓库为每种语言提供了独立目录static/tutorial/en、static/tutorial/ja、static/tutorial/fr、static/tutorial/de等其中日语版对应的还有 zettelkasten.md 与 citing.md共同构成完整的入门三部曲。教程是如何被装载进应用的从源码看教程的启动由命令类 TutorialOpen 实现其核心流程非常清晰从应用安装目录定位tutorial文件夹扫描所有语言子目录通过 find-lang-candidates.ts 按当前界面语言匹配最合适的语言目录精确匹配优先其次是相近语言最后回退到en将语言目录内的全部文件复制到用户系统的「文档」目录下的Zettlr Tutorial文件夹中若目标已存在则跳过不覆盖用户文件通过roots-add命令把该目录注册为工作区并设置为当前打开目录程序化地打开welcome.md、split-view-intro.md与helpful-links.md并自动生成三栏分屏布局——左侧主编辑区是 welcome.md右侧上下分别为分屏视图介绍与实用链接文档。这就是为什么首次运行 Zettlr 时左侧文件管理器里会立刻出现一个名为「Zettlr Tutorial」的文件夹且当前文件被高亮显示。教程文件本身含references.json参考文献库都存放在仓库的 static/tutorial/ja/ 目录下。阅读教程前必须先知道的两个约定教程中会出现大量可点击的网页链接但 Zettlr 的默认交互逻辑是直接单击链接 进入编辑该链接的状态。想要真正打开链接需要macOS 按住Cmd键点击其他平台按住Ctrl键点击。文中的Cmd/Ctrl一律表示「macOS 用Cmd其余系统用Ctrl」。另外随时可以按F1或通过「帮助」菜单打开在线文档。工作区Workspace与文件管理器的三种显示模式教程开篇就点明了 Zettlr 最重要的设计哲学Zettlr 是围绕工作区概念构建的。所谓工作区就是一组被应用「加载」的文件夹它包含当前应用内打开的所有文件。建议始终至少保持一个工作区目录处于打开状态并在其中完成全部写作工作工作区会在每次启动应用时自动重新加载并持续显示在目录树中。关闭Close右键目录选择关闭表示将该工作区从应用中卸载文件仍保留在磁盘上删除DeleteZettlr 会把文件移入系统回收站而非永久删除。注部分 Linux 发行版上移入回收站依赖特定系统包可能无法开箱即用遇到删除问题时需检查系统的回收站支持情况。文件管理器左侧边栏默认使用combined模式——文件与文件夹像系统文件浏览器一样交错显示。除此之外还有两种模式模式行为combined树视图同时显示文件与文件夹默认thin仅显示文件夹预览/目录导向expanded文件与文件夹分开显示两者均可见这三种取值在配置校验中被硬编码为白名单见 config-validation.ts 中的fileManagerMode: required|string|in:thin,expanded,combined|default:thin而默认值combined与说明注释位于配置模板 get-config-template.tsfileManagerMode: combined, // thin Preview or directories visible --- expanded both visible --- combined tree view displays also files sortFoldersFirst: true, // should folders be shown first in combined fileview可以看到combined模式下还有一个配套选项sortFoldersFirst决定文件夹是否优先于文件显示。如果你已有存放笔记的文件夹可以直接点击工具栏的「打开工作区…」按钮或使用快捷键Cmd/CtrlO日语版教程原文标注英文版教程标注为Cmd/CtrlShiftO具体以你所安装版本的快捷键设置为准立即打开。Markdown 基础四个最常用的元素Zettlr 是 Markdown 编辑器工作方式与 Microsoft Word、LibreOffice、Apple Pages 类似但无需点击大量工具栏按钮——只用字符即可赋予文本结构全程不需要离开键盘。教程总结了四个最核心的语法元素粗体与斜体用下划线或星号包裹文本。1 个字符 斜体_italic_2 个字符 粗体**bold**3 个字符 粗斜体__*bold and italic*__。具体用下划线还是星号可完全按个人习惯对应的编辑器配置项为boldFormatting: **与italicFormatting: _见 get-config-template.ts 的 editor 段标题像发 hashtag 一样输入#后跟一个空格即可最多 6 个######可创建 16 级标题列表新行写*、-或即无序列表数字加点1.即有序列表引用块与邮件中的引用文本写法完全一致用标记即可。除此之外Markdown 还有大量其他元素例如脚注在正文任意位置写[^1]在文件任意位置通常是文末写[^1]: 脚注内容即可。Zettlr 支持鼠标悬停直接预览脚注文本无需滚动到文件底部——这正是「写作体验尽量无摩擦」的体现。教程中的脚注示例原文为智能链接剪贴板识别的Cmd/CtrlK魔法链接是 Markdown 的强大工具Zettlr 将其提升到了新的高度核心亮点是对剪贴板内容的智能识别。教程给出了一个可立即复现的实战步骤复制一个有效的网页链接到剪贴板例如https://fosstodon.org/zettlr在编辑器中选中想要作为链接文本的词组按下Cmd/CtrlK——Zettlr 检测到剪贴板中有合法网页链接自动将其作为链接目标插入为了让文本更易阅读Zettlr 默认自动隐藏链接目标 URL只显示链接文本即渲染为普通文本样式而非完整 URL。如果你不喜欢这些默认渲染元素中的某一个可以在「显示Display」偏好设置中逐个关闭。此外Zettlr 不只支持网页链接——如果链接指向你电脑上的某个文件点击该链接可以直接打开对应文件。教程同时预告了 Zettlr 最具特色的内部链接wiki 链接形如[[zettelkasten]]。从 zettelkasten.md 可知单击内部链接时 Zettlr 会同时执行两件事对链接内容发起全文搜索并尝试打开对应文件——这正是 Zettelkasten 知识管理的基础。跟随内部链接后的行为可以在 Zettelkasten 偏好设置中定制对应配置段见 get-config-template.ts 的zkn对象zkn: { idRE: (\\d{14}), idGen: %Y%M%D%h%m%s, linkAddFileTitle: true, linkWithIDIfPossible: false, linkFormat: link|title, // Determines what internal links ([[link|title]]) look like autoSearch: true, // Automatically start a search upon following a link? customDirectory: // If present, saves auto-created files here }autoSearch: true即「跟随链接时自动搜索」的默认开关idRE/idGen则定义了 Zettlr 为笔记生成唯一 ID默认 14 位时间戳格式的规则用于实现不依赖文件名的稳定链接。侧边栏四个各司其职的页签点击工具栏右上角形似「竖排柱子」的图标即可打开侧边栏它包含四个页签目录ToC动态生成当前文档的目录点击标题即可跳转到正文对应位置参考文献References列出当前文档中引用的文献是核查「我到底引用了什么」的强力工具。注意侧边栏中的参考文献只使用内置引用样式排版导出文档时如果在「导出」偏好设置中配置了引用样式CSLZettlr 会改用所选样式。仓库的 static/csl-styles/chicago-author-date.csl 与 static/csl-locales/ 提供了内置的 CSL 样式与多语言 locale 支持相关文件Related FilesZettlr 通过分析所有文件中使用的标签与内部链接来判断文件间相关性。列表顶部是「链接到当前文件」的文件其后是按共同标签数量排序的文件——共同标签越多排名越靠前其他文件Other Files显示当前选中目录下的所有非 Markdown 文件。例如教程目录中的LaTeX Guide.pdf点击即可用系统默认 PDF 阅读器打开。交互式元素复选框与表格编辑器编辑器中的部分元素是可交互的。教程用一个三连复选框让读者自测进度文件与目录的操作学会 Markdown 基础安装用于导出文件的 LaTeX而表格则是交互性最强的元素之一鼠标悬停在表格上时会浮现一组操作按钮。教程中的示例表格完整如下FilePurposeFilenameWelcome to Zettlr!Gives a basic overview over the abilities of Zettlrwelcome.mdWorking with a ZettelkastenIntroduces the various Zettelkasten-features of Zettlrzettelkasten.mdCiting with ZettlrHighlights the capabilities of working with references databasesciting.md通过表格编辑器你可以调整列对齐、增删行与列。编辑器始终作用于当前激活的行或列——例如要删除某行必须先确保该行内至少有一个单元格处于选中状态。这个交互背后是仓库中的 table-editor 模块见 source/common/modules/markdown-editor/table-editor/而相关开关是编辑器配置中的enableTableHelper: true默认开启。从入门到进阶后续资源与下一站至此welcome.md 的第一部分入门介绍结束。教程明确建议的进阶方向包括标签管理器Tag ManagerZettlr 提供强大的标签管理能力可集中过滤、重命名与管理所有标签全文搜索灵活的全局搜索选项在教程目录中已可体验Cmd/Ctrl点击[[zettelkasten]]内部链接即可跳转并会看到搜索结果被高亮显示。关于 Zettelkasten 的用法细节可继续阅读 static/tutorial/ja/zettelkasten.md包括两种交叉链接方式按文件名[[zettelkasten]]或按唯一数字 IDCmd/CtrlL为文件生成 ID、标签的「模糊」关联语义标签云按使用次数列出所有标签以及引用的用法见 static/tutorial/ja/citing.md。教程配套的示例参考文献库即 static/tutorial/ja/references.json配合编辑器内置的引用自动补全插件源码见 source/common/modules/markdown-editor/autocomplete/citations.ts其中citeStyle配置项决定补全为[CiteKey]、CiteKey []还是行内作者-年份形式即可完成「输入触发补全、自动生成引用、侧边栏汇总参考文献」的完整工作流。小结welcome.md 虽然只是交互式入门教程的开篇却已经完整覆盖了 Zettlr 的四大基石工作区文件管理combined/thin/expanded 三种模式、Markdown 即写即得编辑粗斜体、标题、列表、引用、脚注、智能与内部链接剪贴板识别的Cmd/CtrlK与 Zettelkasten 的[[...]]交叉链接以及信息密集的侧边栏目录/参考文献/相关文件/其他文件。配合 tutorial-open.ts 的装载流程与 get-config-template.ts 的配置默认值读者既能顺利完成首次上手操作也能在源码层面理解每个行为背后的机制——这正是继续深入 Zettlr 功能集的最佳起点。【免费下载链接】ZettlrYour One-Stop Publication Workbench项目地址: https://gitcode.com/GitHub_Trending/ze/Zettlr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考