Markdown 与维基链接

显示模式

.md 笔记会以编辑器和阅读并排的方式打开（可配置）。 在光标所在段落之外，标记会淡化显示，使页面看起来像一篇完成的文档。

快捷键：Ctrl+B/Ctrl+I 应用加粗/斜体，Ctrl+E 循环切换视图模式（编辑 → 分栏 → 格式化 → 阅读）。

/ 菜单：在格式化编辑器中，于行首（有缩进也可以）或空格之后输入 /，插入列表就会在光标处打开。输入即可筛选（/表格、/标注、/h1），用 ↑/↓ 选择、Enter 插入；Esc 或空格关闭列表，已输入的内容保留为文本。右侧一列显示该项写入的标记 — 下次可以直接输入。在代码块、公式和表格单元格中不会打开该菜单。

阅读模式：Ctrl+E 的最后一个模式与格式化编辑是同一个界面，但是只读的——正因如此，它可以显示文件里没有的内容：[TOC] 标记的目录。[files] 标记的文件夹列表和用 ![[笔记]] 嵌入的笔记正文也会出现在格式化编辑里。这些都不会写入 .md：文件里保留的仍是标记，生成出来的文字也不接受编辑。在该模式下单击即可跟随链接、wiki 链接和标签（无需 Ctrl），编辑类按钮则被禁用——包括撤销、剪切和粘贴，它们此前会作用于屏幕外的文本编辑器。复制仍然可用，复制的就是你看到的内容。 Ctrl+F 在屏幕上的内容中查找；替换那一行被禁用，原因写在提示里——在这里替换不会写进文件。

阅读模式里的带单位计算。以 = 结尾的行会得到结果：3,5 km / 2 s = 显示为 3,5 km / 2 s = 1,75 km/s。文件不会改变 —— 和 [TOC]、排好的引用是同一个想法。它做量纲分析，这正是它的立身之处：1 km + 1 s = 会被拒绝并指出这两个单位，因为在那里返回 2 的计算器不是更差，而是在说谎；在实验记录里，这个错误会一路活到论文里。把同一个量的不同单位相加是可以的，并会换算（2 h + 30 min =），结果会用你写的单位给出。它认识 SI 词头、物理常数（c、h、k_B、N_A、g 等）、显式换算（3 km in m，也可用 to 和 ->）以及不确定度：(2,00 ± 0,05) m / (1,0 ± 0,1) s = 会传播误差，并只写出测量允许的位数。代码和公式不参与 —— 在 ``` 围栏里、反引号之间或 $…$ 中，行尾的 = 是别的东西的语法。不是算式的行（合计 =）会安静地保持原样。

默认是关闭的：在设置 → 功能 → 学术 → 带单位的计算器里打开。

间隔重复卡片。 给笔记加上 #flashcards 标签，它就成为一个 牌组：在其中，每一行 问题::答案 就是一张卡片，::: 会同时生成反向卡片，两行之间单独一行的 ? 构成多行卡片， ==这样== 则成为填空。没有标签，任何笔记都没有卡片——这正是为了避免 编程笔记里的 std::vector 变成一张你从未写过的卡片。工具 → 卡片 → 复习卡片 打开复习会话：答案会一直藏着，直到你主动要求（这就是整个功能——把两边一起看 就是重读，而重读记不住），四个评分上直接写着各自能买多少时间。安排复习的是 FSRS，与 Anki 相同的算法。

卡片的身份是「问题」：改正答案不影响复习计划， 而改写问题会让那张卡片退休并开始一张新的——这是对的，因为你学的正是问题。历史记录保存在 笔记旁边的开放文件里（笔记.md.cards.ndjson）：可以用 Git 版本管理， 任何编辑器都能读，代价是文件夹里多一个文件。导出到 Anki 会写出它能导入的文本文件 ——复习计划不会一起走，因为 Anki 的文本导入不接受它；计划仍留在 .ndjson 里。

代码块

代码块会带上颜色。声明了语言的围栏（```python）会逐个标记高亮显示，使用与代码编辑器相同的配色——包括为本窗口选择的代码主题。格式化编辑、阅读模式、导出的文件以及询问笔记的回答中都有效。未声明语言的围栏仍为单色，没有可用高亮的语言也是如此：文本绝不会因此消失。

折叠、固定与导出

折叠章节和固定标题在格式化编辑和阅读模式下同样有效。Ctrl+Shift+[ 折叠光标所在的章节，Ctrl+Shift+] 展开它；点击标题左侧的小箭头效果相同，视图 → 折叠所有标题 / 展开所有标题 作用于当前显示的界面。滚动时，滚出顶部的标题会固定在顶部的横条中——点击其中一个即可跳转到该章节。折叠是界面状态：.md 不会改变，折叠的文字仍留在文件中。

导出：PDF 和 HTML 都由与阅读模式相同的文档生成——导出的文件就是你刚刚读到的内容，包含目录、文件夹列表和嵌入的笔记。HTML 是自包含的（本地图片会被内嵌），PDF 使用矢量文字，因此可以检索。HTML 采用语义化标记——标题带锚点、提示框用 <aside>、表格带表头、脚注可返回——并且公式是 MathML：真正的文字，可复制、可朗读，放大也不会模糊。 主题随格式而定：HTML 保留你在屏幕上看到的颜色，包括深色主题（文件自带背景）；PDF 始终使用浅色纸张，因为它是用来打印和发送的——如果你的内容主题是深色，就用默认的浅色主题打印；你已经在用的浅色主题则会保留。 Word、OpenDocument、LaTeX、Typst 和 EPUB 由 LightNote 自己生成，无需安装任何东西。

.docx 和 .odt 带有标题、列表、表格、脚注和图片，公式会成为可编辑的公式（在 Word 中是 Word 公式，在 LibreOffice 中是 Math 对象）；.tex 带有完整的导言区，可用 pdfLaTeX、XeLaTeX 和 LuaLaTeX 编译。如果文件夹里有文献目录且学术一节已开启，.tex 会带活的引用：[@键] 变成 \autocite，[bibliography] 记号变成 \printbibliography，并在旁边写入只含所引文献的 refs.bib——应用会告诉你它写了。请用 biber 编译。

.typ 是同一件事在 Typst 上的做法：几秒即可编译，无需安装 LaTeX 发行版；公式通过 mitex 包（首次编译时下载）以 LaTeX 形式带过去，引用写作 @键 并配 #bibliography。

.epub 是电子书：每个一级标题为一章，带导航目录，图片作为包内文件，并采用与 HTML 相同的语义化标记。.ipynb 是 Jupyter 笔记本：正文变成文本单元格，内核语言的代码块变成代码单元格——只有它，因为代码单元格会被送给内核，把 Mermaid 图变成单元格后，第一次运行就会被当作 Python 执行。内核取自笔记属性里的 kernel 键，没有则取最常见的代码块语言。

输出不会被编造：单元格输出为空，因为结果来自运行——这和导入笔记本时丢弃已保存输出是同一条规则。还有Markdown 目标：同一篇笔记按目标的方言输出——GitHub 用 > [!NOTE] 提示框，MkDocs 用 !!! note，Docusaurus 用 :::note，Pandoc 用 ::: {.note}，也可以用 Obsidian 写法或严格的 CommonMark。

wikilink 会转成相对链接（Obsidian 除外），而 %%…%% 注释不会被发布，因为它是私人的。如果装了 Typst（winget install --id Typst.Typst），导出完成后会直接给出编译 PDF；没装时按钮变成安装 Typst...，打开安装向导。如果课程或客户给了 Word 模板，请在工作区设置 → 引用与参考文献 → Word 模板中指定它的 .docx：导出的文件会带上模板的样式、纸张、页边距和页眉。某篇笔记可以在属性里写 reference-docx: moban.docx 来改用别的模板。三者都从阅读模式的 Markdown 出发——引用已格式化，图片已编号——，没能带过去的内容会在导出结束时告诉您。编译作为活动中心中的一项任务在后台运行：窗口仍可操作，停止可中断编译。

Mermaid 图和化学结构以图片形式放入：在 .docx、.odt 和 EPUB 中画在浅色纸上，在 HTML 中使用屏幕配色；只有通过没有窗口可供绘制的 lnote 导出时，它们才会以代码块输出。此外还有标记文本目标…：reStructuredText、AsciiDoc、Org mode、MediaWiki 和纯文本，同样由 LightNote 自己写出。每一种都用它自己的原生写法，而不是模仿：方框在 Sphinx 里是 .. note::，在 AsciiDoc 里是 [NOTE]，在 Org 里是 #+begin_note；公式分别是 .. math::、latexmath:[]、纯 LaTeX 和 <math>；脚注则是 footnote:[] 和 <ref>。纯文本不带任何标记——表格按列对齐输出，正好放进邮件或提交信息里。目标格式没有的东西会在最后告诉您：MediaWiki 的核心没有方框（它会变成带粗体标签的引用），reStructuredText 没有删除线。想不写文件就带走一段内容，可以用编辑器右键菜单中的将选区复制为（未选中时为将笔记复制为）：可粘贴到 Word、Google 文档或邮件中的带格式文本、GitHub Markdown、LaTeX 和 Typst。LaTeX 和 Typst 仅含正文——没有导言区和标题——因为目标文档已经有了；这段内容需要的宏包，以及依赖目标文档文献目录的引用，会在状态栏中提示，%%…%% 注释也不会带过去。

RTF 位于更多格式 (pandoc)，通过单独的程序 pandoc 完成（winget install --id JohnMacFarlane.Pandoc）：没有它时，这个目标会显示为禁用并附上原因，同一子菜单里的安装 pandoc...会打开向导并完成安装。如果 pandoc 已装在别处，请在向导的已经装了：从磁盘中选择...或设置 → 代码工具 → 外部程序中指定文件。

带选项导出...是导出菜单的第一项——标签页的菜单和文件 → 导出笔记是同一个菜单。它列出所有目标格式，可以按名称、用途和扩展名搜索（wiki 找到 MediaWiki，sphinx 找到 reStructuredText），并且只显示对所选格式有效的选项：笔记还没有 [TOC] 时的开头加目录；决定断字和文档自动生成的标签的文档语言；LaTeX 和 Typst 的引用（保持活引用，或在正文中解析）；带有“设为此文件夹的默认模板”复选框的Word 模板；HTML 和 EPUB 的公式用 MathML 还是图片（适合旧的电子书阅读器或贴进邮件的 HTML）；PDF 的纸张，A4 或 Letter；以及随后用 Typst 编译 PDF。适用但无法使用的选项会禁用并说明原因（例如文件夹里没有参考文献时的活引用），依赖缺失程序的目标格式会当场提供安装。最后一次的选择会按文件夹记住，对话框会按您离开时的样子重新打开；菜单里的直接项目仍然使用出厂设置导出，免得几周前的一次选择改变快捷方式生成的文件。笔记里写的 [TOC] 在所有目标格式中都有效：在 Word 和 LibreOffice 中成为目录（Word 在打开时更新），在 LaTeX 中成为 \tableofcontents，在 Typst 中成为 #outline()，在 HTML 和 Markdown 中成为链接列表。在将选区复制为的带格式文本里，公式和图以图片形式带过去，替代文本是 LaTeX 源码：那里不知道文本会被粘贴到哪里，而在 Word、Google 文档和邮件里显示一致的只有图片——需要可编辑的公式时，请导出 .docx 或 .odt。

整个文件夹也能导出：文件 → 导出文件夹...（或在树中右键点击一个文件夹）会把它的笔记变成一个 HTML 站点——每条笔记一个页面，如果没有笔记已经变成 index.html，还会生成一个索引页——，或者一套 .docx / .odt，或者按目标方言写成的 Markdown 目录树。子文件夹结构保持不变，笔记之间的链接和维基链接会指向导出的文件（在 Word 和 LibreOffice 里也是，从一个文档指向另一个），文件夹内部的图片和附件也会一起带走，位置照旧。文件夹外面的东西不会被复制：它保持你写下的样子，最后的报告会连同没有目标的链接一条条列出来。目标文件夹必须是空的——或者你勾选 替换同名文件——而且不能包含被导出的文件夹。没有窗口也行：lnote folder-export --path . --format html --out site，以及 MCP 的 folder_export 工具；在那里嵌入、[files] 和图号不会被解析，因为解析它们的是窗口。

格式化编辑

格式化编辑（WYSIWYG）：第四种模式显示笔记的成品样子——标题用标题字号、 列表带项目符号、表格是网格、图片就在正文里——而不是标记。文件仍然是同一个 .md：写文件的是 LightNote 而不是 Qt，所以加粗、斜体、维基链接、嵌入和提示框 都能经受住来回转换。进入该模式又不作编辑地离开，文件一个字节也不会变。工具栏只提供 Markdown 能表示的东西——标题、加粗、斜体、删除线、代码、列表（含任务复选框）、引用、 链接、表格和水平线；对齐、缩进和字号不在其中，因为保存时会丢失。

在表格里，Tab 在单元格之间移动，在最后一个单元格上创建下一行。 在表格右侧的空白处（点击某行右边时光标会落到那里）按 Enter，会在表格末尾新增 一行，光标停在第一个单元格。 在单元格里，Enter 就地换行（写入文件时是 <br>，这是 Markdown 表格唯一接受的形式），Ctrl+Enter 则在下方新增一行，光标停在同一列。 把鼠标移到表格上会出现低调的手柄：行的左边是上下移动它的一对箭头（也可以 拖动把它带到别处），列的上方是左右移动它的一对，下边框和右边框上各有一个 +，分别新增一行和一列。第一行是表头，不会移动。这些在右键菜单的 表格里也都有；那里还有 删除表格，这是整张表格移除的安全做法。

在方框（<details> 或 :::）里，最后一行用于闭合 方框，无法删除：正是它让下面的内容不会被方框吞进去。要在保留文字的前提下取消 方框，请使用右键菜单里的移除方框。Enter 总是新增一行。在空的列表项里， 它离开列表而不新增行（和 Word 一样）；在空段落里，它新增空行。文件中的一个空行是段落之间 的正常分隔，不会显示为空行；从第二个开始才会显示，并按你写的样子回到文件里。

拖动图片右边缘可以调整大小，宽度会以 ![alt|300](foto.png) 的形式写入文件。工具栏有十二个控件：粗体、斜体和标题直接放置，其余按用途分入两个菜单——格式作用于已经写下的内容（标记、列表、引用、表格对齐以及文本操作），插入则创建新内容（链接、图片、表格、块、图表、公式、提示框）。格式化表格和文本菜单仍属于文本编辑器：在这里它们显示为禁用，并说明原因。淡化标记移到了显示按钮，与在四种模式下都可用的阅读栏和打字机滚动相邻。而插入菜单在这里提供与文本编辑器相同的内容——高亮、上标、下标、维基链接、脚注、提示框（callout）、可折叠块、目录和定义列表——即这个模式已经会显示却不会创建的一切。

阅读模式显示的东西，格式化编辑现在也显示。 表情符 :fire: 显示为 🔥，==高亮== 显示为黄色标记，^2^ 和 ~2~ 显示为上标和下标，#标签 显示为药丸形，裸露的网址显示为链接。文件保持写下来的形式：打开笔记不会改写任何内容。在已渲染的片段内部编辑会保留标记——在高亮中间输入仍然是高亮——而紧接其后输入的字符会留在外面。注释 %%…%% 仍然可见，只是淡化：把它藏起来会让它既看不见又无法编辑。

标注在格式化编辑中也会变成方框。 以 > [!NOTE]（或 [!TIP]、[!IMPORTANT]、[!WARNING]、[!CAUTION]）开头的引用会显示为带颜色的竖条和标题，和阅读模式一样：标记让位给类型的名称，或者在你写 > [!TIP] 我的标题 时让位给你自己的标题。文件里仍保留写下的标记，编辑标题也不会改变标注的类型。 Obsidian 和 MkDocs 的提示框名称同样能识别：[!SUCCESS]、[!ABSTRACT]、[!FAILURE]、[!QUESTION] 及其别名（tldr、missing、faq）会落到最接近的提示框，从那里带来的笔记直接就有颜色；导出时，每个目标会收到它认识的名称。

这是全新安装时的默认模式。已经在使用 LightNote 的用户会保留原有模式；如需更改，请使用设置 → 常规 → Markdown 初始视图。点击大纲中的标题会在当前模式内跳转，不会把你带出格式化编辑或阅读模式。

对齐表格的列。将光标放在表格内，右键菜单会提供 表格 → 列对齐：左对齐、居中、右对齐 或 默认。对齐作用于 整列——Markdown 就是这样表示的——并会写入文件的分隔行（:--、:-:、--:）；默认 会回到 ---。菜单上的勾选告诉你当前生效的是哪一个：在屏幕上，--- 列和 :-- 列看起来一样。

大纲显示屏幕上的内容。标题列表来自你正在看的那个面：在 格式化编辑 中，刚输入的标题会立即出现，不必等文本传到文本编辑器；在 阅读模式 中，它还包括用 ![[笔记]] 嵌入的笔记的标题——它们也是你正在阅读的内容。两种情况下，单击条目都会跳到正确的标题。而在 分屏模式 下，滚动现在是双向的：滚动阅读窗格会带着文本编辑器一起走，就像反方向一直那样。

标记在输入时变成格式。输入 **测试** 会应用加粗并去掉星号； *斜体*、~~删除线~~、`代码` 以及下划线形式同理。 在行首，#  到 ######  变成标题，-  和 1.  变成列表（输入的数字就是起始编号），- [ ]  变成带复选框的任务，>  变成引用，单独一行的 --- 按 Enter 变成水平线。会画出东西的标记在空格时就生效； 只有标题要等第一个字符，因为空标题在屏幕上什么也不显示。

Ctrl+Z 只撤销这次转换， 把字面标记还回来——这是真的想写星号的人的出路。粘贴也会转换：带标记的文本粘贴进来会以格式化的样子出现，没有标记符号。这里的判定比输入时更谨慎——只有明确的标记才会触发——因为粘贴时你看不到结果成形：这样一段满是 * 和 _ 的代码仍然是代码。代码块里不转换任何东西，因为那里标记本身 就是主题。要全部关闭：设置 → 常规 → 输入时转换标记。

从 Word、Google 文档或网页粘贴时，进来的是带结构的文本：标题、列表（包括 Word 那种底层并不是列表的）、表格、链接、行内代码，以及带语言的代码块。来源的字体、字号和颜色不会进来：Markdown 无法表达它们，留着只会多出一段保存后就消失的蓝色 Arial 文字。 随文本一起粘贴的图片，如果是 Word 或浏览器放在临时文件夹（会自动清空）里的，就会成为笔记的附件；指向互联网的图片保持原样，它的右键菜单提供 把图片下载到工作区。

图片、链接与维基链接

图片和链接。插入图片有三条路：工具栏的 插入 → 图片…、 输入 ![](foto.png)，或者把文件拖进笔记——拖图片插入图片，拖 .md 笔记插入 [[维基链接]]，其他文件则变成以文件名为标签的可点击链接； 一次拖入多个文件时，每个各占一行。保存的路径尽可能相对于笔记所在的文件夹，这样移动笔记库之后笔记仍然能用。 链接的地址不会出现在正文里（看到的是标签），所以鼠标悬停时会显示在状态栏， Ctrl+点击可以打开：网址交给浏览器，本地路径在 LightNote 里打开。

编辑已有的链接：把光标放进去，用工具栏的 链接 按钮（或右键菜单的 编辑链接…）——对话框会带着文本和地址打开。链接上的右键菜单还有 复制链接地址 和 删除链接，后者去掉链接而保留文字。在 [[维基链接]] 上有 打开笔记 和 复制目标；在 #标签 上有 搜索标签 和 复制标签。在图片上有 替代文本…（格式化模式里看不到，但它会写入文件、进入搜索），拖过手柄之后还有 原始大小，把图片还原成它本来的大小。在网址图片上会出现 把图片下载到工作区：文件会放到笔记旁边的 附件/，笔记指向它—— 否则笔记就得依赖那个网址一直存在。 还有最短的一条路：选中一段文字再粘贴网址，它会变成 [文字](网址)，而不是替换掉选中的内容。两个编辑界面都适用。 在下载之前，网络图片会显示成一张写着网址和菜单路径的卡片——LightNote 渲染笔记时不会访问网络，而以前那里只有一个空的破图方框，什么也不说明。

标记也可以取消。 在格式菜单里，高亮、上标和 下标在光标位于其中时会显示为已勾选，点击就是取消标记，而不是再 应用一次。键盘上有快捷路径：把光标放在带格式文本的末尾， Ctrl+Shift+Backspace 会还原字面标记并少一个字符——粗体变成普通 文本的 **粗体*——补上缺少的定界符就会重新形成格式。粗体、斜体、删除线、 代码、高亮、上标和下标都适用。单独的 Backspace 删除一个字符，这里和别处 一样。

不离开笔记也能编辑图表。在格式化编辑器里，Mermaid 图表和 $$…$$ 公式是画出来的；要改源文本，把光标放上去按 Ctrl+Enter， 或用右键菜单里的编辑此块…。底部的条会显示文本，条打开时笔记处于锁定状态，关闭它 （✕、Esc、Ctrl+Enter、点一下笔记）就是应用，回头路是 Ctrl+Z。同一个菜单里的 提取为新笔记…会把选中的片段写到旁边一篇新笔记里，并在原处留下一个 [[wikilink]] —— 标记也一起带走，所以标题、列表和表格会完整地到达新笔记。字段只显示内容本身：```mermaid 与 ``` 两行（或 $$）变成了工具条标题栏中的类型选择器，它还能在图表、公式和代码块之间切换。Enter 会保留该行的缩进——在 Mermaid 这类依赖缩进的语言里，这是每一行都要做的动作。块的右键菜单提供复制 Markdown 代码和复制图片——代码粘到任何 Markdown 编辑器都会重新绘制，图片则可以粘到邮件或聊天里。两者在仅阅读模式下同样可用。

让 AI 来改。块的编辑栏打开时，标题行里的 AI 按钮会展开一行， 在那里写下要改什么 —— “加一条回到起点的出错路径”、“把求和换成积分” —— 按 Enter 发送。输入框旁边有一个按钮，显示由哪个 AI 来回答： 它的菜单只为这个块换助手，不动你的默认 AI，并且带有 查看将要发送的内容。 值得看一眼，因为 AI 收到的不只是这个块，还有笔记的标题和小节以及 周围的文字 —— 正因如此，你才可以要求图表反映那里写的内容。回答会填进字段， 图当场重画：Ctrl+Z 会把你原先写的内容找回来。LightNote 会用自己的渲染器 检查回答，画不出来时，把被拒绝的那一行和那个命令告诉模型，只请求一次 修正 —— 再不行就照样写进去，并把原因留在栏里，方便你手动改那两行。 这个按钮只在图表、公式和化学结构上出现。

指向某个小节，以及用属性打标签。[[笔记#小节]] 会在那个小节处打开笔记——锚点指的是标题文字——而 ![[笔记#小节]] 只嵌入那一段（到下一个同级或更高级的标题为止，包含其中的小标题）。对不上任何标题的锚点 会在状态栏说明，嵌入保持原样：在那里换成整篇笔记，等于悄悄给出另一样东西。另外，frontmatter 里的 tags: 现在算作笔记的标签，两种写法都算（tags: [a, b] 和分行的列表）——它们会进入 Bases、标签搜索以及助手看到的内容，和正文里的 #标签 一起。 不写笔记名时，锚点指向笔记本身：[[#结论]] 会跳到该小节而不打开任何标签页，![[#结论]] 则把该小节嵌入到你所在的位置。锚点还可以嵌套：[[论文#方法#样本]] 指的是方法里面的那个样本，而不是笔记中第一个同名标题。 第三种形式指向一个块：以 ^id 结尾的行（或紧接在块下方、只有 ^id 的一行）就是 [[笔记#^id]] 的目标。LightNote 不会创建这些标识符，它只把你带到你写下的地方。而当目标不是笔记时，锚点指的是它内部的位置：[[论文.pdf#page=3]] 会在那一页打开 PDF。

维基链接: 输入 [[ 会从工作区的笔记中自动补全， 链接会以 ]] 自动闭合。按住 Ctrl 单击 [[笔记]] 会打开对应的笔记。 连接面板会显示笔记之间的关联。 Obsidian 的内嵌图片也会显示：![[照片.png]] 会被画成图像，![[照片.png|300]] 还会遵守宽度。文件里保留的仍是你写下的写法——图片路径绝不会被写进去替换掉这个记号。

不是图片的附件会变成卡片：![[论文.pdf#page=3]]、![[讲课.ogg]] 和 ![[地图.canvas]] 会显示为带文件名的方框，可以点击——PDF 会在你指定的页码打开。Obsidian 的 .canvas 和 .base 多一行，说明文件仍在文件夹里，而 LightNote 不绘制它。不存在的目标保持你写下的样子：在那里放一张卡片，等于承诺一个已经丢失的文件。 在句子中间，图片照样显示，附件则只显示文件名，Ctrl+单击即可打开：在那里放一个方框会把段落拆开。 同一则笔记的另一个名字：在笔记属性里写 aliases: [抽样, 抽样方法]，[[抽样]] 就会打开它——别名也会进入 [[ 的自动补全。若有同名文件，文件始终优先于别名。别名来自文件夹的索引，应用在打开工作区时会在后台重建它：刚写下的 aliases: 会在下一次扫描后生效，而不是同一秒。

标签面板

标签面板。侧边栏的条带里有一个标签分区：笔记中所有 #标签 的树，按 / 嵌套（#project/alpha 和 #project/beta 成为 project 的分支），旁边是笔记数——按笔记计数，而不是按出现次数。选中一个标签，下方就列出带有它的笔记（父节点也会显示分支里的）；双击打开笔记。面板读取索引，因此两种来源都看得到：正文里的 #标签 和 frontmatter 里的 tags:。在笔记里 Ctrl+单击某个标签会打开这个面板并选中它——以前打开的是对 #标签 的全文搜索，那样找不到在 frontmatter 中声明标签的笔记。要找正文里字面出现的地方，请继续用全局搜索。

提示框、脚注与扩展标记

丰富阅读: 用围栏包起来的代码块会显示在带语言标签和复制链接的框中； ~~删除线~~ 和 ==高亮== 会被渲染；GitHub 风格的标注 （> [!NOTE]、[!TIP]、[!WARNING]、 [!IMPORTANT]、[!CAUTION]）会变成彩色框。#hashtag 标签会高亮，并可用 Ctrl+单击打开对该标签的搜索；顶部的 YAML frontmatter 块（---）也会高亮。标签工具栏上有一个按钮可将笔记导出为 PDF/HTML，还有居中且可切换的阅读栏，以及笔记的显示模式。 Zen 模式（F11）和打字机滚动有助于无干扰地写作。

脚注可以双向跳转。 引用 [^1] 显示为上标数字，Ctrl+单击它会跳到定义处；在定义处，[^1]: 标记仍然可见——它是跳转的目标，你需要看到它才知道正在编辑哪条脚注——在它上面 Ctrl+单击则回到引用处。与许多 Markdown 查看器不同，编辑器不会给脚注重新编号，也不会把定义移到末尾：文件的顺序是你的。 Obsidian 和 Pandoc 的行内写法 —— ^[脚注的正文] —— 同样会渲染：正文写在调用脚注的位置，阅读模式下它会带编号出现在末尾。文件里保留的仍是你写下的内容，导出时它会变成 Word、LaTeX、Typst 和 EPUB 中真正的脚注。

MkDocs 的标注（!!! note 加上用 4 个空格缩进的正文）在格式化编辑中按写下的样子保留：正是缩进让正文属于该标注，所以其中的文字不会获得富文本格式——作为交换，打开笔记并保存不会破坏这个结构。

带结束标记的方框也会显示为方框。 :::tip … :::（Docusaurus）和 <details> … </details> 会获得带颜色的竖条和标题，紧凑写法和带空行的写法都一样。开始标记让位给类型名称、你写的标题，或 <summary> 里的文字；结束标记从屏幕上消失，但仍留在文件里，因为应用自己写下的标记不该原样留在页面上。留在屏幕上的是方框的最后一行：正是它界定了方框，也是把光标放进去继续写的地方，而且它删不掉——删掉的话，下面的内容就会被方框吞进去。要在保留文字的前提下取消方框，请使用右键菜单里的移除方框。定义列表的 : 仍然会淡化。 <summary> 必须与 <details> 在同一行才会变成标题：单独占一行时它会按原样显示，方框保留默认名称。

行内 HTML 与代码块。 <kbd>、<mark>、<sub> 和 <sup> 在格式化编辑中同样会被渲染——标签消失，只留下内容，和阅读模式一致。用围栏包起来的代码块会获得一个方框，角落显示语言名称和复制——在格式化编辑和阅读模式下都可用，而那正是最常复制代码的地方。它只取围栏里的内容（不含标记），并短暂显示已复制；两个标签都只在不压住代码时才出现。

阅读的更多功能：开头的 YAML frontmatter 块不会显示在渲染后的笔记中——它在属性面板中编辑。#hashtag 标签会变成可点击的标签块，点击后打开该标签的搜索（与编辑器中的 Ctrl+单击相同）。Obsidian 风格的注释（%%这段不会显示%%，或用只含 %% 的行包围的块）只保留在文件里。除了 GitHub 的标注框，Docusaurus（:::tip 标题 … :::）和 MkDocs（!!! note "标题" 加缩进正文，以及 ??? note）这两种写法也会渲染成同样的框——阅读文档仓库时很方便。

阅读的新功能: 除了 ~~删除线~~ 和 ==高亮==，还支持上标 ^x^、下标 ~x~、 快捷表情（:rocket:）、URL 自动链接、脚注 [^1]、可折叠块 <details>、定义列表、 任务 - [ ]/- [x]（⬜/✅）以及 [TOC] 标记（可点击的目录）；还支持本地图片和行内 HTML （<kbd>、<mark>…）。大纲面板 （标签工具栏）会跟随光标浏览标题，插入按钮（或右键菜单 → 格式/插入）可应用任何标记。

标题、文件夹与文本操作

固定标题（sticky scroll）：滚动时，包含顶部行的标题会固定在编辑器顶部的条带中；点击即可跳转到该章节（在设置 → Markdown 中开关）。在树中右键单击文件夹可创建/打开文件夹笔记（带 frontmatter 的 index.md），可用作索引。

文件夹笔记与文件列表：双击文件夹会打开其 index.md（若存在）。在任意笔记中，单独占一行的 [files]（或 [arquivos]）标记会在格式化编辑和阅读中被替换为该笔记所在文件夹的文件列表（可点击的链接）——即时生成，不向文件写入任何内容（与 [TOC] 相同）。

文本与行操作。 代码编辑器的操作在笔记中同样可用——通过标签栏的格式按钮下的文本子菜单、 右键菜单，以及编辑菜单的行与清理子菜单：把当前行（或选中的多行）上/下 移动（Ctrl+Shift+↑/↓）、复制（Ctrl+Shift+D）、删除 （Ctrl+Shift+L）、排序（A→Z / Z→A）、反转顺序、合并行、删除 重复行或空行、删除空格以及大小写（大写／小写／反转）。行编号…会打开 一个对话框，可设置起始值、步长、前导零和分隔符；使用默认值 （". "）即可得到有效的 Markdown 有序列表。有选区时只作用于选区（会扩展到整行）； 没有选区时作用于整个文档——始终只占一步撤销。标签栏还提供 AI 按钮：询问 / 用 AI 编辑，与代码中相同的 Ctrl+K / Ctrl+I；还有询问笔记，即用工作区的笔记来回答的聊天。

建议标题和标签。笔记的同一个 AI 按钮中的建议标题和标签…会请默认助手为打开的笔记提出标题和标签。助手会读取笔记（长笔记只读开头和结尾）以及你在工作区中已在使用的标签列表，并优先复用它们，而不是另造同义词。建议显示在一个可编辑的小窗口中：可以修改标题，取消勾选或更正标签。应用会把 title: 和 tags: 写入笔记的属性——标签只会追加到已有标签之后，绝不替换——如果笔记既没有标题也没有 # … 标题行，还会询问是否把标题也放到顶部。这是一次编辑：Ctrl+Z 即可撤销。未配置任何 AI 时，该项会引导你连接一个。如果助手是云端服务，笔记文本会离开本机；使用本地模型则不会。

可折叠标题：点击标题左侧的小箭头（或使用 Ctrl+Shift+[ / Ctrl+Shift+]）即可折叠或展开该小节；视图菜单中有折叠/展开所有标题。 折叠纯粹是视觉效果——绝不会写入文件——并且 LightNote 会在会话之间记住它。从大纲或搜索 跳转到已折叠小节内部时，会自动展开该小节。

活页夹：把文件夹当作一部作品

这是什么：一个文件夹，其中的笔记按你声明的顺序成为章。写书、写毕业论文、做课程、写手册、写运维手册或工作日志，机制都一样。在文件夹的右键菜单中选择转换为活页夹，会打开一个按当前顺序排列笔记的窗口：拖动排序后确认。顺序保存在该文件夹 index.md 的 chapters: 键里——那是你自己的文本文件，会随笔记一起移动，在任何机器上都继续有效。 子文件夹也可以写进顺序：它的各章会进入它出现的位置，而它在自己的 index.md 中声明自己的顺序——一本书就是这样有了“部”。子文件夹的封面不会成为文档的页面；它用来声明那一层的顺序，以及用来导航。

导航：声明顺序后，笔记的工具栏会显示第 3 章，共 12 章，两侧各有一个箭头（Alt+PgUp 和 Alt+PgDn）；中间的按钮列出所有章。大纲面板改为显示两级：作品的各章，以及当前打开那一章下面的标题。到了作品的两端，对应的箭头变灰。在没有声明顺序的文件夹里，这些都不会出现，一切照旧。

笔记模板：活页夹可以声明在其中创建的笔记从哪个模板开始（template: 键）。内置五个模板——书籍章节、毕业论文章节、课时、操作步骤和日志条目——选择其一会把它保存为 Templates 文件夹中的文件，在那里可以随意修改。在活页夹内部创建的笔记会自动进入顺序；从外面放进来的文件会留在顺序之外，直到你把它收进来。重命名一章会同时修正键，并保留它的位置。 若想从现成的作品结构开始，文件夹右键菜单中的从模板构建结构…会一次写入两个键——顺序和章节模板——并保留你已经写好的封面；只要还有声明了却尚不存在的章节，大纲就会显示一个按钮，一次把它们全部创建出来，每一章都已经出自该文件夹的模板。不会覆盖任何内容：已经存在的章节保持原样。

合并为一个文档：导出文件夹时，勾选将各章合并为一个文档会生成一个文件，各章按声明的顺序排列。由于文本是在渲染之前合并的，脚注、图、表和引用随后会在整个文档中统一编号——从某一章引用另一章的图也开始生效。不在声明顺序中的内容不会包含，报告会说明是哪些。

属性、主题与缩放

笔记属性：属性侧栏把 YAML frontmatter 显示为带类型的字段 （文本、数字、日期、复选框），顶部有类型选择框。设置类型和属性，正是把笔记汇集到 基库的前提。

笔记主题：属性面板中的主题下拉框用于设定这篇笔记的外观 （正文的颜色与字体），而不会改动应用其余部分的主题。 所选内容会写入 frontmatter（theme 键），因此它会随文件一起移动： 在任何机器上打开这篇笔记，外观都一样。 旁边的按钮会把颜色写进笔记本身，这样即使对方没有这个主题，看到的也一样。 没有该键时，笔记跟随工作区的主题。 如果不希望从外部收到的笔记改变你的外观，请在设置 → Markdown 中 关闭尊重笔记中声明的主题。

LightNote 尚未认识的主题：主题列表是从网站下载的单个文件， 因此，如果笔记引用的主题是在你上次更新之后发布的，就会找不到它。 这时笔记会以工作区的主题打开，属性面板会给出提示，并附上查看可用主题的快捷方式。 LightNote 会自行查找更新后的列表——每个会话一次，在后台进行，不会让笔记等待。 如果你希望它从不获取任何内容，请在设置 → 功能中 关闭在线获取工具目录。

Ctrl++ 和 Ctrl+−（或 Ctrl+鼠标滚轮）可改变笔记的大小，Ctrl+0 回到 100%——适合阅读长笔记而不改动所有笔记的字体。编辑器与阅读一起缩放：分栏模式下两侧始终一样大。直接写在笔记里的 <svg> 也会在阅读中绘制：可以把 AI 生成的图表直接粘进来，不必另存为文件。

多少词，算哪一段。状态栏统计笔记的词数并估算阅读时间；旁边的 章节 N 是光标所在章节的词数 —— 与大纲高亮的范围相同，从该标题起， 到下一个同级或更高级的标题为止。在设置 → 笔记与写作里设定 每日目标后，还会出现今天 N/M：今天打开的笔记中增加的部分。 删除不会倒扣 —— 修改自己的文字不该变成惩罚 ——，没打开过的笔记不计入，到了午夜 清零。