HydroMark 用户手册（中文版）
适用版本： 1.1.x 适用平台： Windows + Microsoft OneNote 2013 / 2016 / 2019 / 2021 / Microsoft 365（桌面版） 插件选项卡： HydroMark
目录
- 简介
- 系统要求与安装
- 快速上手
- 功能区（Ribbon）说明
- 渲染与源码模式
- Markdown 语法支持
- 代码块与语法高亮
- 数学公式
- Mermaid 图表
- 提示框
- 表格
- 斜杠命令面板
- AI 助理
- 页面管理与目录
- 主题与外观
- 导入与导出
- 试用期、许可证与购买
- 自定义快捷键
- 快捷键总表
- 多语言支持
- 常见问题与故障排除
- 附录：Markdown 语法速查
1. 简介
HydroMark 是一款 OneNote Markdown 插件（OneNote Markdown 加载项，也就是 COM 加载项），运行在 Windows 上的 Microsoft OneNote 桌面版里，Markdown 直接在 OneNote 页面内编写并渲染成 OneNote 原生格式内容。输入 # 加空格，这一行立刻变成标题；输入 -、* 或 + 加空格，立刻变成项目符号；其余语法写完按 Enter 渲染。按 / 随时呼出斜杠命令面板，搜索并插入模板；功能区「目录悬浮窗」打开悬浮目录，点标题即跳转到对应位置；「当前页全宽」「新建全宽页面」和表格全宽（Alt+W 可切回按内容自适应）给你更宽的版面。另外还有代码高亮、LaTeX 数学公式、Mermaid 图表、提示框、整页一键导出干净的 Markdown，以及能直接执行插件操作的内置 AI 助理，界面共 12 种语言。
核心特性
| 特性 | 说明 |
|---|---|
| 即时渲染 | # 加空格秒出标题、- / * / + 加空格秒出项目符号；其余语法按 Enter（或 Ctrl+Space / F5）渲染 |
| 源码模式 | 整页在 Markdown 源码与渲染视图之间双向切换 |
| 代码高亮 | 200+ 编程语言语法高亮，100+ 配色主题可选 |
| 数学公式 | LaTeX 行内公式与块级公式（专业版） |
| Mermaid 图表 | 26+ 种图表类型：流程图、时序图、类图、甘特图、思维导图等（专业版） |
| 提示框 | 信息 / 警告 / 重要 / 错误四种彩色提示框（专业版） |
| 表格 | 原生表格渲染，快捷键加行加列，整页全宽 ↔ 按内容自适应双向切换 |
| AI 助理 | 内置 AI 侧边栏：对话生成内容并直接执行插件操作（插入内容、渲染、导出等） |
| 斜杠命令 | 输入 / 呼出命令面板，快速插入 Markdown 模板 |
| 导入导出 | 一键导出页面为 .md 文件（可带图），从剪贴板导入 Markdown |
| 全宽页面与目录 | 「新建全宽页面」「当前页全宽」撑满编辑区；「目录悬浮窗」悬浮目录点标题即跳转，「显示目录」把目录写进页面 |
| 主题定制 | 代码块、语法高亮、命令面板均可切换主题，代码块可自动跟随 OneNote 深色模式 |
| 多语言 | 简体中文、繁体中文、英、日、韩、法、德、西、俄、葡、阿拉伯、印地 12 种界面语言 |
| 原生渲染 | 全部元素使用 OneNote 自带控件渲染，与笔记无缝融合 |
2. 系统要求与安装
系统要求
- Windows 7 及以上
- Microsoft OneNote 2013 及以上（桌面版；Mac 版和移动版暂不支持）
- .NET Framework 4.8 及以上
安装步骤
- 下载安装包 安装包为多语言合一版本，自动适配 32 位和 64 位 OneNote，无需按 Office 架构选择。
- 运行安装程序 双击安装包，按照向导完成安装。
- 验证安装 启动 OneNote，顶部菜单栏应能看到 HydroMark 选项卡，点击后可见全部 Markdown 编辑工具。
卸载
- 打开 控制面板 → 程序和功能
- 找到 HydroMark 条目
- 右键选择 卸载，卸载后重启 OneNote
3. 快速上手
第一步：启用自动渲染
- 打开 OneNote，点击顶部 HydroMark 选项卡
- 在「渲染」分组中，点击 自动渲染，使其显示 ✔ 选中状态
第二步：编写 Markdown
在 OneNote 页面中直接输入 Markdown 语法，例如：
# 一级标题
这是 **加粗** 文本，这是 *斜体* 文本。
- 列表项 1
- 列表项 2
第三步：即时渲染
输入完毕后按 Enter，当前行立即渲染为格式化内容。 使用拼音等输入法选词时的 Enter 不会误触发渲染，可放心输入中文。
第四步：查看和编辑源码
- 按 Ctrl+, 切换到源码模式，整页内容还原为 Markdown 源码，可自由编辑；再次按 Ctrl+, 返回渲染模式
- 也可以随时按 Ctrl+Space 只对当前行做渲染 / 还原切换
4. 功能区（Ribbon）说明
安装后 OneNote 顶部会出现 HydroMark 选项卡，包含 9 个功能分组：
4.1 渲染（Render）
| 控件 | 说明 |
|---|---|
| 自动渲染 | 切换开关。启用后按 Enter 自动渲染当前行 |
| 渲染 | 手动渲染当前行（等同 Enter / Ctrl+Space） |
| 渲染整页 | 一键渲染当前页面所有 Markdown 内容（等同 F5） |
| 源码模式 | 切换源码 / 渲染模式（等同 Ctrl+,） |
4.2 导入/导出（Import/Export）
| 控件 | 说明 |
|---|---|
| 导出 MD | 将当前页面导出为 Markdown（等同 F8） |
| 导入 MD | 从剪贴板导入 Markdown（等同 Ctrl+Shift+V） |
4.3 代码（Code）
| 控件 | 说明 |
|---|---|
| 复制 | 复制当前选中代码块的内容 |
| 清空 | 清空当前选中代码块的内容 |
| 代码语言 | 下拉选择代码块编程语言，支持 200+ 种语言 |
4.4 页面（Page）
| 控件 | 说明 |
|---|---|
| 新建全宽页面 | 在当前分区新建一个全宽页面 |
| 当前页全宽 | 将当前页面的内容区域扩展为全宽 |
| 页面宽度 | 下拉菜单，设置整页渲染时的页面宽度 |
| 显示目录（切换后为"隐藏目录"） | 显示 / 隐藏基于页面标题自动生成的目录 |
| 目录悬浮窗 | 打开悬浮目录面板，点击条目跳转到对应标题 |
页面宽度选项：
| 选项 | 尺寸 | 适用场景 |
|---|---|---|
| A4 | 794pt | 标准文档、打印预览 |
| Letter | 816pt | 北美标准文档 |
| A3 | 1123pt | 大幅面内容、海报 |
| 自动 | 基于内容 | 根据内容自动调整 |
4.5 表格（Table）
| 控件 | 说明 |
|---|---|
| 加列（Alt+C） | 为光标所在的表格增加一列 |
| 加行（Alt+R） | 为光标所在的表格增加一行 |
| 表格宽度（Alt+W） | 在整页全宽与按内容自适应（窄表）之间切换光标所在的表格 |
4.6 主题（Theme）
| 控件 | 说明 |
|---|---|
| 代码主题 | 设置代码块背景配色：深色 / 浅色 / 紫色 / 蓝色 |
| 高亮主题 | 设置语法高亮配色，100+ 主题可选（vs、github、monokai、dracula、nord 等） |
| 面板主题 | 设置斜杠命令面板的配色：深色 / 浅色 / 紫色 / 蓝色 |
💡 自动跟随 OneNote 深色模式： 只要你没有手动选择过「代码主题」或「面板主题」，它们会自动跟随 OneNote 的深色 / 浅色模式实时切换（含语法高亮配色）。一旦手动选择任一主题，即固定为你所选的主题。
4.7 AI（AI）
| 控件 | 说明 |
|---|---|
| AI 助理（Alt+A） | 打开 AI 助理侧边栏，对话生成内容并执行插件操作 |
| AI 大模型设置 | 配置 AI 服务商、接口地址、API Key 与模型 |
4.8 设置（Settings）
| 控件 | 说明 |
|---|---|
| 设置菜单 | 包含：快捷键设置、更新设置、许可证 |
| 购买 | 按钮文字随许可证状态变化：试用/未激活显示"购买"，基础版显示"升级"，专业版显示"终身" |
4.9 网站 / 帮助 / 关于
| 控件 | 说明 |
|---|---|
| 网站 | 打开 HydroMark 官网 |
| 帮助 | 打开帮助窗口，查看快捷键和功能说明 |
| 关于 | 查看版本信息 |
5. 渲染与源码模式
HydroMark 提供四种渲染路径，覆盖不同场景：
| 方式 | 操作 | 范围 |
|---|---|---|
| 自动渲染 | Enter（需开启「自动渲染」开关） | 当前行 |
| 手动渲染 | Ctrl+Space | 当前行（渲染 / 还原来回切换） |
| 整页渲染 | F5 或「渲染整页」按钮 | 整个页面 |
| 源码模式 | Ctrl+, 或「源码模式」按钮 | 整页还原为 Markdown 源码 / 整体渲染 |
要点：
- Ctrl+Space 是"当前行"级别的双向开关：Markdown ↔ 渲染结果，编辑已渲染内容时最常用
- Ctrl+, 是"整页"级别的源码模式：适合批量修改、从别处粘贴 Markdown 后统一处理
- 修改已渲染的内容：把光标放回该行按 Ctrl+Space 还原成源码再改，或直接 Ctrl+, 进入整页源码模式
6. Markdown 语法支持
6.1 标题
支持 6 级标题，使用 # 号标记：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
6.2 强调文本
**粗体文本** → 粗体
*斜体文本* → 斜体
~~删除线文本~~ → 删除线
==高亮文本== → 高亮标记
**_粗斜体_** → 粗斜体
6.3 行内代码
这是 `行内代码` 片段
渲染为灰色背景的等宽字体片段。
6.4 引用
> 这是一段引用文本
> 可以多行
6.5 分隔线
以下三种写法均可：
---
***
___
6.6 无序列表
- 项目 A
- 项目 B
也支持 * 和 + 作为列表标记。
6.7 有序列表
1. 第一步
2. 第二步
6.8 任务列表
支持中英文两种格式：
- [ ] 未完成的任务
- [x] 已完成的任务
- 【】未完成的任务（中文写法）
- 【√】已完成的任务
渲染后，未完成任务显示为 ☐，已完成显示为 ☑ 并带删除线和灰色文字。
6.9 链接
[显示文本](https://example.com)
6.10 图片
支持本地路径和网络 URL，也可以通过斜杠命令插入后选择本地图片文件。
6.11 表格
| 姓名 | 年龄 | 城市 |
| --- | --- | --- |
| 张三 | 28 | 北京 |
| 李四 | 32 | 上海 |
渲染为 OneNote 原生表格，之后可用 Alt+C / Alt+R 加列加行。第二行的 --- 分隔线是必需的，它告诉 HydroMark 这是一个表格。
6.12 脚注
这是一个脚注引用[^1]，还可以有第二个[^note]。
[^1]: 这是第一个脚注的内容。
[^note]: 脚注可以有更长的名字。
[^id] 渲染为上标编号，脚注定义行渲染为页面底部的小字注释。
7. 代码块与语法高亮
基本用法
使用三个反引号围栏包裹代码，并指定语言：
```csharp
public class Hello
{
public static void Main()
{
Console.WriteLine("Hello, World!");
}
}
```
支持的语言
支持 200+ 种编程语言，常用包括：
| 分类 | 语言 |
|---|---|
| Web 前端 | html, css, javascript, typescript, jsx, tsx, vue, sass, less |
| 后端 | csharp, java, python, go, rust, php, ruby, c, cpp, swift, kotlin |
| 数据库 | sql, mysql, postgresql, mongodb, graphql |
| 脚本 | bash, powershell, shell, bat |
| 标记 | xml, json, yaml, toml, markdown, latex |
| DevOps | dockerfile, makefile, nginx, apache |
| 其他 | r, matlab, scala, haskell, elixir, dart, lua |
代码块操作
- 复制代码：选中代码块后，点击功能区「复制」按钮
- 清空代码：点击「清空」按钮
- 切换语言：使用「代码语言」下拉框选择语言（渲染前后均可切换）
8. 数学公式（专业版）
支持 LaTeX 公式在 OneNote 中原生渲染。
行内公式
使用单个 $ 包裹：
质能方程 $E = mc^2$ 是物理学最著名的公式。
块级公式
使用双 $$ 包裹，居中独立显示：
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$
公式示例
| 公式 | Markdown 输入 |
|---|---|
| 行内公式 | $x^2 + y^2 = z^2$ |
| 求和 | $$\sum_{i=1}^{n} i = \frac{n(n+1)}{2}$$ |
| 矩阵 | $$\begin{pmatrix} a & b \\ c & d \end{pmatrix}$$ |
| 分数 | $\frac{a}{b}$ |
| 根号 | $\sqrt{x^2 + y^2}$ |
| 极限 | $\lim_{x \to 0} \frac{\sin x}{x} = 1$ |
⚠️ 注意： 公式语法需成对闭合（
$...$或$$...$$），未闭合时不会触发渲染。
9. Mermaid 图表（专业版）
支持 26+ 种 Mermaid 图表类型。图表渲染为图片后嵌入 OneNote；需要修改时按 Ctrl+Space 还原到源码编辑后再渲染。
基本用法
```mermaid
flowchart TD
A[开始] --> B{判断}
B -->|是| C[执行]
B -->|否| D[结束]
```
常用图表类型
| 类型 | 关键字 | 用途 |
|---|---|---|
| 流程图 | flowchart |
业务流程、决策树 |
| 时序图 | sequenceDiagram |
接口交互、系统通信 |
| 类图 | classDiagram |
面向对象设计 |
| 状态图 | stateDiagram-v2 |
状态机、生命周期 |
| 实体关系图 | erDiagram |
数据库设计 |
| 甘特图 | gantt |
项目进度规划 |
| 饼图 | pie |
数据占比分布 |
| 思维导图 | mindmap |
知识梳理、头脑风暴 |
| 时间线 | timeline |
事件时间轴 |
| Git 图 | gitGraph |
Git 提交历史 |
| 用户旅程图 | journey |
用户体验分析 |
| 象限图 | quadrantChart |
技术评估、优先级 |
| 桑基图 | sankey-beta |
流量 / 资源分配 |
| 雷达图 | radar-beta |
多维能力评估 |
| ZenUML | ```zenuml |
程序时序 / 代码逻辑 |
更多语法请参考 Mermaid 官方文档。
10. 提示框（专业版）
HydroMark 支持 4 种彩色提示框，使用 @@ 标记（标记独占一行，内容之后用 @@ 结束）：
@@INFO
这是一条信息提示（蓝色）
@@
@@WARN
这是一条警告提示（黄色）
@@
@@IMPORTANT
这是一条重要提示（橙色）
@@
@@ERROR
这是一条错误提示（红色）
@@
| 类型 | 标记 | 外观 |
|---|---|---|
| 信息 | @@INFO |
蓝色调 |
| 警告 | @@WARN |
黄色调 |
| 重要 | @@IMPORTANT |
橙色调 |
| 错误 | @@ERROR |
红色调 |
提示框为 HydroMark 自定义语法，标准 Markdown 不支持；导出
.md时会保留原样。
11. 表格
创建表格
通过 Markdown 语法创建表格（见 6.11），输入后按 Enter 或 F5 渲染。默认渲染为整页全宽、列宽均分，视觉整齐适合大表。
全宽与内容自适应（窄表）双向切换
将光标放在表格内，按 Alt+W（或功能区「表格宽度」按钮）即可双向切换：
- 整页全宽：表格铺满页面宽度，列宽均分——适合宽表、数据表
- 按内容自适应：表格收窄到内容实际宽度——适合两三列的小表、参数表
切换结果会保存在页面里，重新渲染整页也不会变回全宽。
加行加列
| 操作 | 快捷键 | Ribbon 按钮 |
|---|---|---|
| 添加一列 | Alt+C | 加列 |
| 添加一行 | Alt+R | 加行 |
⚠️ 使用前请确保光标位于已渲染的表格区域内。
12. 斜杠命令面板
打开方式
在 OneNote 页面中输入 /（斜杠），命令面板会贴着光标弹出。
使用方法
- 输入
/弹出命令面板 - 直接按键即可过滤（中文支持拼音首字母搜索，如 "CT" = 粗体），无需点击搜索框
- 用上下方向键选择，按 Enter 确认（或鼠标点击）
- 命令模板插入到光标位置，光标停在
{cursor}标记处 - 按 Esc 取消
命令列表
文本格式化：粗体、斜体、删除线、高亮、行内代码
标题：标题 H1 ～ H6
区块：引用、代码块、分隔线
列表：无序列表、有序列表、任务列表
提示框：信息框（@@INFO）、警告框（@@WARN）、重要提示框（@@IMPORTANT）、错误框（@@ERROR）
公式：行内公式 $...$、块级公式 $$...$$
链接和媒体：链接 []()、图片 ![]()
表格与图表：表格（带分隔行模板）、Mermaid 图表代码块
💡 标题、引用、分隔线、任务列表、表格等命令插入后会立即渲染。
13. AI 助理
HydroMark 内置 AI 助理侧边栏：你用自然语言提出要求，AI 生成内容并直接在页面里执行插件操作——不只是聊天，而是把结果写进你的笔记。
打开方式
- 点击功能区「AI 助理」按钮，或按 Alt+A
- 侧边栏停靠在 OneNote 主窗口右侧，跟随窗口移动和缩放，可边聊边编辑
它能做什么
| 能力 | 说明 |
|---|---|
| 写入笔记 | 让 AI 写大纲、总结、表格、代码示例等，直接插入当前页面光标处 |
| 插入表格 | 让 AI"做一个任务排期表"，可指定整页全宽或紧凑宽度 |
| 操作页面 | 让 AI 渲染整页、切换源码模式、设置页面宽度（A4/Letter/A3/自动）、页面全宽、显示/隐藏目录 |
| 操作表格 | 让 AI 给当前表格加行加列、切换全宽 / 内容自适应 |
| 导出 | 让 AI 导出当前页面为 Markdown |
| 识别专属语法 | 会生成 @@ 提示框、```mermaid 图表、LaTeX 公式等 HydroMark 专属语法 |
| 看图说话 | 输入框 Ctrl+V 粘贴剪贴板图片，AI 可基于图片内容回答并写入笔记 |
| 语言跟随 | 回复语言自动跟随你最后一条消息的语言（用中文问就中文答） |
发送与中断
- 点击「发送」或直接发送即可；AI 回答过程中可随时点「停止」
- 侧边栏支持清除全部聊天记录（垃圾桶图标，需二次确认）
AI 大模型设置
点击功能区「AI 大模型设置」（或侧边栏设置按钮）：
- 选择服务商：内置 14 家具名服务商预设——OpenAI (ChatGPT)、DeepSeek（深度求索）、Kimi（月之暗面）、智谱 GLM、阿里·通义千问、腾讯混元、百度千帆、字节跳动·火山方舟、Claude、Microsoft Azure OpenAI、Grok (xAI)、Google Gemini、小米、OpenRouter；列表末尾还有一项「自定义」（任何 OpenAI 兼容接口：中转站、vLLM、Ollama、LM Studio 等）
- 填写接口地址与 API Key：地址可修改；API Key 使用 Windows 加密存储，仅本机可解密
- 选择模型：可点击「刷新模型」在线获取最新模型列表，也可手动输入——厂商上新模型无需升级插件
- 测试连接：保存前先验证配置是否可用
- 可保存多套大模型配置，随时一键切换当前使用的一套
⚠️ 多模态提示： 所选服务商 / 模型不支持图片输入时，粘贴的图片会被忽略并给出提示，请换用支持多模态的模型。
许可证要求
- AI 助理需要有效许可证：试用期、基础版、专业版均可使用，需先激活或购买
- 基础版可通过 AI 使用全部基础功能，但无法让 AI 执行专业版专属操作（图表 / 公式 / 提示框 / 面板主题），会给出升级提示
14. 页面管理与目录
全宽页面
OneNote 默认页面宽度较窄。HydroMark 提供全宽页面功能：
- 新建全宽页面：在当前分区创建一个新的全宽页面
- 当前页全宽：把当前页面的内容区域扩展到全宽
这两个功能目前只有功能区按钮，未绑定快捷键（表格全宽另有 Alt+W）。
页面宽度设置
整页渲染时可在「页面宽度」菜单指定目标宽度：A4（794pt）/ Letter（816pt）/ A3（1123pt）/ 自动（基于内容）。
目录功能
HydroMark 有两种目录，都基于页面中已渲染的标题（H1-H6）生成：
一、插入到页面里的目录
- 确保页面中包含 Markdown 标题且已渲染
- 点击功能区「显示目录」按钮
- 目录显示在页面中，列出所有层级标题；再次点击「隐藏目录」即可收起
二、悬浮目录面板
- 点击功能区「目录悬浮窗」按钮
- 弹出一个无边框、总在最前的小窗，列出当前页所有标题并按层级缩进
- 点任意条目即跳转到对应标题；面板不遮挡编辑区，可拖动标题栏移动、拖动边框调整大小
- 面板打开后不会跟着页面实时刷新，新写了标题就点面板里的「刷新」重新收集；点「关闭」收起
悬浮面板只是一个独立的置顶小窗，不会作为 OneNote 的停靠窗口出现，也不参与 Alt+Tab 窗口切换。
15. 主题与外观
HydroMark 提供三组独立的主题设置，都在功能区「主题」分组：
15.1 代码主题
控制代码块背景与边框：深色 / 浅色 / 紫色 / 蓝色。
15.2 高亮主题
控制代码块内的语法着色，提供 100+ 预设配色（vs、github、monokai、dracula、nord、one-dark、solarized 等）。
15.3 面板主题
控制斜杠命令面板的界面配色：深色 / 浅色 / 紫色 / 蓝色。
自动跟随 OneNote 深色模式
从未手动选择「代码主题」或「面板主题」时，插件会自动跟随 OneNote 的深色 / 浅色模式：OneNote 切深色，代码块、命令面板和语法高亮配色同步切到深色系；切回浅色同样自动恢复。手动选择过任一主题后则固定使用所选主题。
16. 导入与导出
16.1 导出 Markdown（F8）
按 F8 或点击「导出 MD」，选择导出方式：
方式一：导出到剪贴板
- 选择「导出到剪贴板」
- 整页 Markdown 文本复制到剪贴板
- 页面中的图片会同时导出为本地文件（默认存于
我的文档\OneNoteMarkDownAddin\export-images\），成功后弹框显示图片数量与所在文件夹
方式二：导出到文件夹
- 选择「导出到文件夹」
- 选择保存位置和文件名（默认取页面标题，重名自动加后缀）
.md文件保存为 UTF-8 编码；图片存到.md同目录的 *image* 子文件夹，Markdown 中使用相对路径
💡 导出功能在试用期和所有付费版本中均可用。
16.2 导入 Markdown（Ctrl+Shift+V）
- 先将 Markdown 内容复制到剪贴板（Ctrl+C）
- 打开目标 OneNote 页面，点击页面内容区域
- 按 Ctrl+Shift+V 或点击「导入 MD」
- 内容被解析渲染并插入到当前光标位置
⚠️ 导入前请先点击页面内容区域（大纲区域），否则会提示"找不到页面内容区域"。
17. 试用期、许可证与购买
17.1 试用期
- 安装后首次使用即开始 14 天免费试用，试用期内全部功能可用（含专业版功能与 AI 助理）
- 剩余 7 天、3 天、1 天时会弹窗提醒
- 为保障授权安全，试用期需定期联网验证（每 6 小时至少一次）；长时间离线会提示联网验证，验证通过后立即恢复
- 系统时间回拨或删除本地试用数据不会延长试用
17.2 许可证与套餐
试用结束后需购买许可证继续使用。套餐分为基础版与专业版两档，各有个人版 / 家庭版，并可选终身买断或按年订阅：
| 功能 | 基础版 | 专业版 |
|---|---|---|
| 实时渲染 / 源码模式 | ✅ | ✅ |
| 代码块 + 200+ 语言高亮 | ✅ | ✅ |
| 任务列表 / 表格 / 脚注 | ✅ | ✅ |
| 导入 / 导出 Markdown | ✅ | ✅ |
| AI 助理（自带 API Key） | ✅ | ✅ |
| 全宽页面 / 目录 / 自定义快捷键 | ✅ | ✅ |
| Mermaid 图表 | ❌ | ✅ |
| LaTeX 数学公式 | ❌ | ✅ |
| @@ 提示框 | ❌ | ✅ |
17.3 激活
- 打开功能区「设置 → 许可证」
- 输入购买后获得的验证码和邮箱，点击「确定激活」
- 激活成功后界面显示 ✅ 已激活状态
- 每个许可证可绑定的设备数量由套餐决定，超出上限时会提示"该激活码已经超出激活机器数量"
- 更换设备时，可先在旧设备上「取消激活」再在新设备激活
17.4 状态显示与失效
- 功能区「设置」分组标题实时显示当前套餐状态（试用期 / 基础终身版 / 专业终身版 / 年费版等）
- 许可证验证未通过时会弹窗提示原因（网络问题或许可证失效），软件会自动重新验证
- 退款或后台禁用的许可证会在下次启动验证时自动失效
18. 自定义快捷键
所有快捷键都可以改成自己喜欢的键：
- 打开功能区「设置 → 快捷键设置」
- 列表显示全部快捷键（功能 / 说明 / 当前按键）
- 双击某一行进入修改，按下新的组合键即可
- 改键带冲突检测，两个功能不能占用同一组合键
- 可将某条设为"无"来停用它；也可一键恢复默认
- 保存后立即生效，无需重启 OneNote
19. 快捷键总表
| 快捷键 | 功能 |
|---|---|
| Enter | 渲染当前行（自动渲染开启时；输入法选词不触发） |
| Ctrl+Space | 渲染 / 还原当前行 |
| Ctrl+, | 源码模式切换（整页） |
| F5 | 渲染整页 |
| F8 | 导出 Markdown |
| Ctrl+Shift+V | 从剪贴板导入 Markdown |
| / | 打开斜杠命令面板 |
| Alt+C | 表格加列 |
| Alt+R | 表格加行 |
| Alt+W | 表格宽度切换（全宽 ↔ 内容自适应） |
| Alt+A | 打开 AI 助理 |
💡 以上快捷键均可在「设置 → 快捷键设置」中自定义；功能区里的「新建全宽页面」「当前页全宽」「显示目录」「目录悬浮窗」是按钮，未绑定快捷键。
20. 多语言支持
HydroMark 支持 12 种界面语言：
| 语言 | 区域代码 |
|---|---|
| 简体中文 | zh-CN |
| 繁体中文 | zh-TW |
| 英语 | en-US |
| 日语 | ja-JP |
| 韩语 | ko-KR |
| 法语 | fr-FR |
| 德语 | de-DE |
| 西班牙语 | es-ES |
| 俄语 | ru-RU |
| 葡萄牙语 | pt-PT |
| 阿拉伯语 | ar-SA |
| 印地语 | hi-IN |
界面语言自动跟随 Office 界面语言，无需手动切换；阿拉伯语采用从右向左（RTL）排版；若 Office 界面语言不在上述 12 种之内，插件界面回退为英语。安装包为多语言合一版本，无需单独下载语言包（安装向导本身：中国大陆版仅提供简体中文，国际版提供全部 12 种）。
21. 常见问题与故障排除
Q：安装后看不到 HydroMark 选项卡
- 重启 OneNote
- 检查 OneNote → 文件 → 选项 → 加载项，确认 HydroMark COM 加载项已启用
- 如仍不可见，重新运行安装包修复安装
Q：按 Enter 没有触发渲染
- 确认「自动渲染」按钮已启用（显示 ✔）
- 检查 Markdown 语法是否正确，成对符号（
**、~~等）是否闭合 - 使用输入法时，选词 Enter 不会触发渲染属正常设计；输入完成后再按一次 Enter 即可
Q：代码块没有语法高亮
- 确保代码块指定了语言：
```csharp而非单纯的``` - 用功能区「代码语言」下拉框手动选择语言
Q：Mermaid 图表渲染失败
- 检查 Mermaid 语法是否正确（注意分号、冒号），可参考 Mermaid 官网示例验证
- 部分带
-beta后缀的图表类型需要较新的 Mermaid 语法 - 如持续失败，重启 OneNote 再试
Q：公式显示异常
- 确保使用成对的
$或$$包裹 - 检查 LaTeX 语法是否正确
Q：导出功能报错
- 导出前确保已点击页面内容区域
- 导出到文件夹时，确保目标路径有写入权限
Q：AI 助理打不开
- AI 助理需要有效许可证（试用期或任一付费版），请先在「设置 → 许可证」激活
- 检查「AI 大模型设置」中的服务商与 API Key 配置，可用「测试连接」验证
- AI 请求失败多为 API Key 无效、额度用尽或网络问题；自建 / 中转接口请确认接口地址正确
Q：AI 粘贴图片没反应
- 所选服务商或模型不支持图片输入时会提示并忽略图片，请换用支持多模态的模型（如 GPT-4o、Gemini、Claude 等）
Q：如何卸载插件？
- 控制面板 → 程序和功能 → 找到 HydroMark → 卸载
- 卸载后重启 OneNote
22. 附录：Markdown 语法速查
# 标题 H1
## 标题 H2
### 标题 H3
**粗体** *斜体* ~~删除线~~ ==高亮==
`行内代码`
> 引用块
- 无序列表
1. 有序列表
- [ ] 任务列表
- 【】中文任务列表
[链接](URL)
[^1]: 脚注定义，正文用 [^1] 引用
| 表头 | 表头 |
| --- | --- |
| 内容 | 内容 |
```代码块```
$行内公式$
$$块级公式$$
@@INFO / @@WARN / @@IMPORTANT / @@ERROR（提示框）