Markdown 语法参考
本文档列出 WeMD 支持的所有 Markdown 语法,包括标准语法和扩展语法。
基础语法
| 语法 | 效果 | 快捷键 |
|---|---|---|
# 一级标题 | 一级标题 | Cmd/Ctrl + 1 |
## 二级标题 | 二级标题 | Cmd/Ctrl + 2 |
**粗体** | 粗体 | Cmd/Ctrl + B |
*斜体* | 斜体 | Cmd/Ctrl + I |
~~删除线~~ | Cmd/Ctrl + Shift + X | |
`行内代码` | 行内代码 | Cmd/Ctrl + Shift + K |
[链接](url) | 链接 | Cmd/Ctrl + K |
 | 图片 | Cmd/Ctrl + Ctrl/Alt + I |
> 引用 | 引用块 | Cmd/Ctrl + Shift + . |
- 列表 | 无序列表 | Cmd/Ctrl + Alt + L |
1. 列表 | 有序列表 | Cmd/Ctrl + Alt + O |
--- | 分割线 | Cmd/Ctrl + Alt + - |
扩展语法
文本样式
| 语法 | 效果 | 说明 |
|---|---|---|
++下划线++ | 下划线 | 快捷键 Cmd/Ctrl + U |
==高亮== | 高亮文本 | 荧光笔效果 |
H~2~O | H₂O | 下标 |
X^2^ | X² | 上标 |
局部属性与自定义样式
可以在段落、标题、表格、图片、链接或已有行内格式后添加 {.class #id data-*=value},再通过自定义主题 CSS 精确设置该元素的样式。
markdown
## 本章摘要 {.chapter-title #chapter-summary}
这是一段需要单独排版的摘要。 {.summary data-kind=abstract}
| 指标 | 数值 |
| --- | --- |
| 阅读量 | 1200 |
{.compact-table #metrics}
{.hero-image #cover}
[查看详情](https://example.com){.cta-link}
这是 **重点内容**{.inline-highlight}。对应的自定义 CSS:
css
#wemd .summary {
padding: 12px 16px;
background: #fff7e6;
}
#wemd .compact-table {
font-size: 13px;
}
#wemd .hero-image {
border-radius: 12px;
}
#wemd .cta-link {
color: #1677ff;
}
#wemd .inline-highlight {
background: #fff1b8;
}行内属性支持链接、图片,以及斜体、粗体、删除线、行内代码、高亮、下划线、上标、下标等已有格式。纯文本不会自动包裹 <span>;需要局部样式时,应先使用一种行内格式。带标题的外链会被 WeMD 转换为脚注,不再生成 <a>,此时紧随其后的属性文本会按原文保留。
属性仅允许 class、id 与 data-*。style、onclick、src、href 等其他属性不会写入或覆盖 Markdown 自身生成的地址;id="wemd"、data-tool 与 data-wemd-* 是系统保留项。列表项、代码围栏、分隔线、软换行和表格单元格暂不支持。需要原样显示以 { 开头的属性写法时,可以写成 \{.class}。
任务列表
markdown
- [ ] 未完成任务
- [x] 已完成任务数学公式
markdown
行内公式:$E = mc^2$
公式块:
$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + ... + x_n
$$GitHub 提示块
markdown
> [!NOTE]
> 背景信息或补充说明
> [!TIP]
> 有用的小技巧
> [!IMPORTANT]
> 重要提示
> [!WARNING]
> 需要注意的问题
> [!CAUTION]
> 高风险操作警告水平滑动图组
适用于在微信公众号中展示可左右滑动的多图:
markdown
<,,>Mermaid 图表
支持流程图、时序图、甘特图等:
markdown
```mermaid
graph LR
A[开始] --> B{判断}
B -->|是| C[执行]
B -->|否| D[结束]
```详见 Mermaid 图表指南。
表情符号
支持 GitHub 风格的 Emoji 短代码:
markdown
:smile: :heart: :thumbsup: