NoteGen Markdown 语法速查
标准 CommonMark 语法
NoteGen 完整支持 CommonMark 规范:
标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
强调
**加粗**
*斜体*
~~删除线~~(GFM)
`行内代码`
列表
- 无序列表项 1
- 嵌套项
- 无序列表项 2
1. 有序列表项
2. 有序列表项
- [x] 已完成任务(GFM 任务列表)
- [ ] 未完成任务
链接和图片
用方括号包裹链接文字,括号内写目标地址。图片语法在链接前面加感叹号。图片路径写相对路径即可。
注意:本站的渲染器会自动注入下载按钮、网盘入口、github 锚文本等外部链接,正文里不要手动写外部 URL。
引用
> 引用块可以有多行
> 第二行
代码块
def hello(): print("Hello NoteGen")
分割线
---
GFM(GitHub Flavored Markdown)扩展
表格
| 功能 | 状态 | 说明 |
|---|---|---|
| 记录 | ✅ | 七种方式 |
| 写作 | ✅ | Markdown + AI |
自动链接
以 https 开头的文本会自动变成可点击链接,不需要用方括号语法包裹。
删除线
~~被划掉的内容~~
XSS 过滤
NoteGen 会自动过滤 Markdown 中的恶意 HTML 标签。
YAML Front Matter
文件头部的元数据块,NoteGen 会识别:
---
title: 页面标题
desc: 页面描述
tags: [笔记, 技术]
---
正文从这里开始...
Front Matter 在编辑器中会特殊显示,方便编辑。
粘贴 HTML 自动转换
从浏览器或其他应用复制 HTML 内容贴进 NoteGen 时,会自动转成 Markdown 格式。保留文字、标题层级、列表、表格等结构,但去掉样式和脚本。
这个功能让"看到好文章 → 复制 → 贴进 NoteGen"变的非常顺。
不支持的语法
| 语法 | 说明 |
|---|---|
双链 [[wiki]] | 作者明确不考虑,因为不方便迁移 |
| LaTeX 完整语法 | 只支持数学公式块($...$ / $$...$$) |
| 自定义 HTML | 安全原因会被转义或过滤 |
语法无关的编辑特性
以下功能不是 Markdown 语法,但在 NoteGen 写作页中高频用到:
- 拖拽排序:列表项、章节可以手动拖动重新排列
- 搜索替换:编辑器内置查找替换面板
- 字符计数:底部显示字数统计
- 多格式导出:HTML、PDF 等(见单独页面)