QOwnNotes Markdown语法完全指南

作为一款强大的笔记应用，QOwnNotes内置了完整的Markdown支持。本文将全面介绍QOwnNotes中的Markdown语法特性，帮助用户高效地组织和格式化笔记内容。

标题与文档结构

在QOwnNotes中，标题不仅用于内容分层，还与笔记文件名自动生成功能紧密相关：

# 一级标题（H1） - 默认作为笔记文件名
## 二级标题（H2）
### 三级标题（H3）
#### 四级标题（H4）

技术提示：

• 导航面板会自动显示标题层级结构
• 一级标题内容将自动成为笔记文件名
• 也可使用底线式标题（仅限H1和H2）

文本样式处理

QOwnNotes支持多种文本修饰方式：

_斜体文本_ 或 *斜体文本*
**加粗文本** 或 __加粗文本__
~~删除线文本~~
_下划线文本_（需在预览设置中启用）

快捷键备忘：

• 加粗：Ctrl+B
• 斜体：Ctrl+I
• 下划线：Ctrl+U
• 删除线：Alt+Shift+S

列表系统

QOwnNotes提供了灵活的列表创建方式：

1. 有序列表项
2. 第二个项目

- 无序子列表
* 星号也可
+ 加号同样适用

使用技巧：

• 回车自动创建新列表项
• 支持多级嵌套列表
• 编辑器内显示与最终预览可能略有差异

链接与引用

外部链接

[显示文本](实际URL)
[带标题的链接](URL "标题文本")
<直接显示URL>

内部笔记链接

[链接到日记](日记.md)
<日记.md> 简写形式

重要提示：

• 内部链接不支持标题属性
• 使用Ctrl+L快速创建链接
• Ctrl+Space可跟踪光标处的链接

图像处理

插入图像的基本语法：

![替代文本](媒体/图片.jpg)

实用技巧：

• 使用Ctrl+Shift+I插入图像
• 支持直接从剪贴板粘贴图片(Ctrl+Shift+V)
• 图片保存在笔记同级media文件夹中

代码展示

行内代码

使用`print()`函数输出内容

代码块

```python
def hello():
    print("Hello QOwnNotes!")
```

语法高亮支持：

• 涵盖主流编程语言（Python、Java、C++等30+种）
• 使用三个反引号加语言标识
• 也可用四个空格缩进创建代码块

高级排版元素

表格

| 左对齐 | 居中对齐 | 右对齐 |
|--------|:-------:|-------:|
| 数据1  |  数据2  |  数据3 |

技巧：

• Alt+Shift+T打开表格辅助工具
• Ctrl+Space自动格式化表格
• 支持从CSV导入

引用块

> 这里是引用内容
> 可以跨越多行

水平分割线

---
***
___

任务列表

- [x] 已完成任务
- [ ] 待办事项

特殊功能

注释

[comment]: # "不会显示的注释"
<!-- HTML注释同样有效 -->

Frontmatter元数据

---
title: 自定义标题
tags: 标签1,标签2
---
# 实际笔记标题

注意：

• Frontmatter不会显示在预览中
• 不影响自动文件名生成
• 支持YAML格式

最佳实践建议

1. 合理使用标题层级构建文档结构
2. 善用代码块展示技术内容
3. 表格适合数据对比展示
4. 任务列表管理待办事项
5. 内部链接实现笔记间关联

QOwnNotes的Markdown实现既遵循通用标准，又加入了许多实用增强功能，使其成为技术笔记整理的理想工具。通过熟练掌握这些语法特性，用户可以创建结构清晰、格式专业的笔记文档。