Markdown 语法参考

下面的示例可以复制到源码模式。Markdown 使用纯文本标记表达结构，建议在段落、列表、表格和代码块之间留一个空行。

基础语法

# 文档标题

## 一个章节

普通文字、**粗体**、*斜体*、~~删除线~~、`行内代码`。

==高亮==，H~2~O，x^2^。

- 无序项目
- 另一项
  - 子项目

1. 第一项
2. 第二项

- [ ] 待完成
- [x] 已完成

> 这是一段引用。

[链接文字](https://example.com)
![图片说明](images/example.png)

---

| 项目 | 数量 |
| --- | ---: |
| 笔记 | 3 |

```javascript
const message = "Hello, Laxvia";
console.log(message);
```

单波浪线 ~内容~ 表示下标，删除线使用双波浪线 ~~内容~~。图片示例要求文档旁实际存在 images/example.png。

引用链接与脚注

[访问示例][example]

[example]: https://example.com "示例网站"

这句话有一条注释。[^note]

[^note]: 这里是注释内容。

[[笔记名称|显示文字]]

公式与图表

所见即所得中的块级公式按内容高度展开，上下标、分式和积分上下限直接显示，无需在公式内部滚动。

行内公式：$E = mc^2$。

$$
\frac{a}{b} + \sqrt{x}
$$

```mermaid
flowchart LR
  A[开始] --> B[编辑文档]
  B --> C[保存]
```

提示块目录与注释

> [!NOTE]
> 这里是需要说明的内容。

> [!TIP]+ 可展开的提示
> 这里是提示正文。

[TOC]

%%这是一段注释%%

目录和注释的扩展呈现需要开启「扩展内容显示」。注释仍属于文件内容，接收 Markdown 文件的人可以在源码中看到它，不应用来隐藏敏感信息。

文档属性示例

YAML 属性区必须放在文件开头：

---
title: 我的笔记
author: 小林
tags:
  - 写作
  - 学习
draft: true
---

# 我的笔记

从这里开始写正文。

TOML 属性区使用 +++，同样放在文件开头：

+++
title = "我的笔记"
tags = ["写作", "学习"]
draft = true
+++

# 我的笔记

扩展兼容范围

常见 Markdown、表格、任务列表、脚注、数学和 Mermaid 可用于日常写作。定义列表、通用属性语法、emoji 短码自动展开、文献引用宏包、Obsidian 跨文件嵌入与块引用，以及 PlantUML 等其他图表语言不作为对应的专用功能提供；这类内容可保留为原文。

所见即所得正文、PDF 和其他 Markdown 软件的扩展支持并非完全一致。需要跨软件使用的文档，优先采用基础语法，并检查目标格式中的实际结果。