跳转到正文
Laxvia使用文档
文档大纲表格与扩展内容

使用指南

表格与扩展内容

使用表格、图片、代码、公式、图表和文档属性。

表格

通过「插入 → 表格」或 Ctrl+Alt+T 创建表格。正文中的单元格可以直接输入,Tab 可用于单元格导航。

正文表格根据内容自动分配列宽,短数字和英文单词优先完整显示,长说明正常换行;宽表超出正文范围时,可在表格内横向滚动。中文短标签仍可能按字换行。PDF 根据纸张宽度重新排版,不提供横向滚动;单个单元格超过纸张内容宽度时会启用应急断行。列数过多或仍无法容纳的内容可能触发溢出提示,需要调整内容或纸张设置。

选中表格后打开扩展编辑,可在单元格边界插入行列,通过删除行、删除列图标减少行列,并设置列对齐。浮层不能输入、粘贴或清空单元格文字;文字修改在正文中进行。

对齐操作作用于选区涉及的整列,包括表头和数据行;左对齐、居中或右对齐会同步到浮层与正文,并随文档保存。

表格浮层的工具栏与网格组成一个完整面板,网格与面板边缘保留间距,并显示完整外框线。上方左侧提供左对齐、居中、右对齐、删除行、删除列五个独立图标,悬停可查看名称;右侧勾选按钮用于完成。单击选中整个单元格,按住鼠标左键拖动可选择矩形区域,松开后保留选区;多选时显示所选行列数,例如「2 行 × 3 列」。按住 Shift 单击或拖动可从已有起点扩选,也可用方向键移动选择,配合 Shift 扩展选区。单元格中的文字和链接均用于选择,不进入文本输入或打开链接。浮层随表格内容伸展,超过窗口可用空间后在网格内滚动,工具栏和表头保持可见;空行、空列也保留可操作的单元格空间。滚动条仅在对应方向的内容超出可用区域时显示,位于网格外侧,贴在内容区右缘和底缘,轨道与交汇处透明,使用细滑块;鼠标或键盘焦点进入表格后滑块更清晰,悬停滑块时加宽。

表头底色延伸至面板右侧边缘,纵向滚动条从表头下方开始,保持表头完整。

选中单元格后,将鼠标移到其边界,出现加号时点击:左、右边界分别在左、右插入一列,上、下边界分别在上、下插入一行。多选时以最后定位的活动单元格为准;插入后选中新增加的空白单元格。表头必须保留在首行,其上边界不允许插入行,下边界可插入数据行。从单元格内部开始拖动只选择区域,不会触发边界插入。

点击「删除行」图标(行图形带减号)或「删除列」图标(列图形带减号),直接删除选区涉及的整行或整列及其中内容;一次批量删除可用 Ctrl+Z 撤销。表头不能删除,选区包含表头时「删除行」不可用;至少保留一列,选中全部列时「删除列」不可用。允许删除所有数据行,再从表头下边界添加。删除后会选中附近保留的单元格。

Markdown 表格适合带表头的规则行列数据;需要复杂版式时,请先确认目标阅读软件对该写法的支持。

图片

通过「插入 → 图片」或 Ctrl+Alt+I 添加图片。图片扩展编辑支持从文件选择、从剪贴板粘贴、替换图片,以及修改图片地址、替代文字和标题;替代文字用于图片无法显示时说明内容。

文件导入支持 PNG、JPEG、GIF 和 WebP。使用本地图片时:

  • 图片已在 Markdown 文件所在目录或其子目录内,可使用相对路径引用。
  • 从目录外导入或从剪贴板粘贴的图片,会放入文档旁的同名 .assets 文件夹。例如,旅行.md 对应 旅行.assets。
  • 重复导入相同内容可复用已有资源。撤销插入或替换会恢复图片引用,但不会删除已创建的图片文件。

移动、备份或分享文档时,请同时携带引用的图片目录,并保持相对位置。仅复制 .md 文件不会把这些外部图片包含进去。

Markdown 图片及图片引用也支持 data:image/png;base64,… 形式的内嵌图片地址,可在源码或图片扩展编辑的「图片来源」中填写。支持 PNG、JPEG、GIF 和 WebP,单张图片解码后不能超过 16 MiB,声明格式必须与图片内容一致。内嵌图片可用于正文、图片预览和 PDF 导出;保存、另存为或保存副本会保留内嵌地址,无需另外携带图片文件。Base64 会增大 Markdown 文件,源码中的图片地址也会较长;文件选择和剪贴板导入仍使用本地图片文件。

图片浮层顶部提供选择图片和粘贴图片图标。图片预览工具栏提供适合窗口、缩小、放大和原尺寸图标,并显示当前缩放比例。图片显示与 PDF 资源读取支持上述内嵌图片和文档目录内的本地相对路径,不直接加载远程图片或任意绝对路径。网络图片请先保存到本地,再通过图片导入功能添加。

代码块

通过「段落与标题 → 代码块」添加代码块,或在源码中使用三反引号围栏。填写语言后,可获得相应语法高亮。

光标位于代码块中时,「段落与标题」显示带方框的代码图标,与行内代码的 <> 图标区分。

代码文字直接在正文中修改。外框模式下可在代码块顶部修改语言、复制代码或折叠代码块;附加信息在源码模式中修改。简洁与外框模式下,仅当代码长行超出当前可用宽度或已发生自动折行时,复制按钮左侧显示「自动换行」图标开关,可临时切换当前代码块的长行显示,小窗阅读时也可使用。直线向右图标表示关闭,折返箭头图标表示开启;该选择不写入文件,重新打开文档后按设置显示。代码块的简洁/外框模式、行号、默认自动换行和语法高亮在「设置 → 阅读与显示 → 代码块」调整。自动换行只是显示变化,不会在代码中插入换行符。

折叠后点击展开按钮恢复显示,折叠和展开不会修改代码内容。从源码模式编辑后切回,也可继续使用这些操作。

数学公式

通过「插入 → 行内数学」或「块级数学」添加公式。行内公式与文字在同一段落中,块级公式单独成段。

公式使用专用数学字体,变量与上下标之间保留少量间距;正文、扩展编辑预览与 PDF 使用相同的公式排版规则。

扩展编辑提供公式预览、可视输入和虚拟键盘,分式、根式、上下标与矩阵可通过图标插入;需要精确修改时展开高级 LaTeX 输入。支持常用 LaTeX 数学写法,不等同于完整的 TeX 排版环境。

公式尚未写完或预览报错时,原文仍可保存。先检查括号、命令和定界符,不必为了保存笔记而删除未完成的公式。

Mermaid 图表

通过「插入 → Mermaid」添加图表,或在源码中使用标为 mermaid 的代码围栏。

扩展编辑可直接修改 Mermaid 源码并查看预览。通过顶部的源码、结构图标切换编辑方式;简单流程图可使用结构编辑,管理节点、连线及方向;复杂图表请使用源码。预览报错时会显示提示及可用的源码片段,位置有效时可直接定位到对应行或列;未完成的图表原文可以保存。

图表由本地 Pele 引擎显示,继续使用 Mermaid 源码。布局和外观可能与其他 Mermaid 阅读器不同;正文、扩展预览与 PDF 共用图表能力。默认按可用宽度调整受支持图表的标签、间距和布局,窄空间下还可自动调整方向。这些显示变化不改写源码中的方向或内容。

图表的装饰外框随「Markdown 内容样式」变化:Laxvia、Github Style 与墨章采用无框留白排版,浅靛使用无描边的圆角底色,雾玻璃使用无描边的透色玻璃表面;Terminal、Cyberpunk 与高对比保留各自风格的边界。正文与新生成的 PDF 使用相同规则,图中节点、子图及作者指定的边框保持原样。

正文和扩展预览中的图表提供放大、缩小和重置缩放按钮。可双击或按住 Ctrl 滚轮缩放,放大后拖动平移;普通滚轮继续滚动文档。图表获得焦点后可使用 +、-、0 和方向键操作。正文按 Escape 将焦点交回图表对象,扩展预览按 Escape 关闭浮层。

在「设置 → 阅读与显示 → 图表」可关闭「自动适应宽度」或「自动调整方向」。两项默认开启;关闭宽度适配后,自动调整方向暂不生效但保留选择,图表使用自然布局,宽图可横向滚动。设置即时影响正文和已打开的扩展预览;已有 PDF 出版预览需点击「更新内容」才采用新设置。

图表不会执行交互脚本、外部资源或文档内的渲染器配置。单图源码上限为 50,000 个字符,流程图及 agentflow 连线上限为 500;超过限制、语法不支持或生成失败时,保留原文并提示。

提示块脚注与目录

提示块适合把补充说明、建议和风险从正文中突出显示,可通过「引用」菜单创建。五种基本类型如下:

类型 用途
说明(NOTE) 补充信息与注意事项
建议(TIP) 更方便的做法与技巧
重要(IMPORTANT) 完成任务需要知道的关键信息
警告(WARNING) 需要留意并及时处理的问题
风险(CAUTION) 操作可能带来的风险或负面结果

也可在源码模式中使用 GitHub 写法:标记单独占一行,正文从下一行开始,每行前都有 >。

> [!NOTE]
> 这里是补充说明,可以使用 **粗体**、链接和列表。

提示块显示类型图标与标题;没有自定义标题时使用 Note、Tip 等类型名称。标题与正文可以原地编辑,也可通过提示块的扩展编辑入口修改类型、自定义标题和折叠状态。清空自定义标题后恢复类型名称,类型名称不会作为正文写入文件。

提示块随当前主题配色与 Markdown 内容样式变化;Github Style 使用 GitHub 风格的彩色左竖线、图标和标题。已有 PDF 需主动更新预览才采用新样式,导出时始终包含完整正文。

已有 Callout 扩展写法继续支持自定义标题,以及紧接标记的 +、-(默认展开、默认收起)。这些扩展不是 GitHub 的基本 Alerts 写法,示例见后文。收起或展开只改变当前显示,不改写文件中的默认折叠设置。

通过「插入 → 脚注」添加注释。脚注引用与定义保持关联,可从引用处编辑脚注正文;浮层优先显示正文,顶部提供加粗、斜体、行内代码、重试写入和复制正文图标,引用上下文与高级操作按需展开。

要在文中显示自动目录,在独立段落写入 [TOC] 或 [[TOC]],并开启「设置 → 阅读与显示 → Markdown 扩展显示 → 扩展内容显示」。目录由标题生成,用于导航;修改目录项应修改对应标题,而不是直接编辑生成的目录文字。

文档属性

通过「插入 → 文档元数据」添加文档属性,也可在文档最顶部编写 YAML 或 TOML 属性区,常用于标题、作者、标签等资料。

所见即所得模式将其显示为可折叠的属性区。短文本、数字、开关和列表可以直接编辑;长文本、字段重命名、类型、排序、删除及复杂原文可通过扩展编辑处理。

无法用表单表达的内容可通过高级原文编辑。输入数字尚未完成时,先补全或撤销当前值,再切换模式或结束操作。

文档属性保存在 Markdown 中,但不会自动生成正文标题、封面或执行任何指令。PDF 正文不包含顶部属性区;需要在 PDF 中显示标题或作者,请另行写入正文。

HTML 与其他写法

部分 HTML 可显示为普通文字、链接、列表等可编辑内容。其他片段可通过「安全 HTML」开关查看受支持的排版,脚本、事件、任意样式和嵌入页面不会运行。

无法直接呈现的语法会保留为原文或局部原文内容。需要修改这些内容时,使用原文编辑入口或源码模式。不同 Markdown 软件支持的扩展不同,分享前应在目标阅读软件中检查公式、图表、提示块等内容。