Markdown
Markdown 是一种轻量级标记语言,使用简洁的语法来格式化文本。相比 HTML,Markdown 更专注于内容本身,语法简单易学,适合用于笔记、文档、博客等场景。
提示
Markdown 标记语言语法与使用
标题
# 标题名字(井号的个数代表标题的级数)Typora: CTRL+数字
CTRL+= 和 CTRL+- 可以提升或降低标题等级
一级标题使用1个#
二级标题使用2个#
三级标题使用3个#
四级标题使用4个#
五级标题使用5个#
六级标题使用6个#
文字属性
文字属性用于控制文本的显示效果,包括删除线、斜体、粗体等。
删除线
这就是 ~~删除线~~ (使用波浪号)Typora: ALT+SHIFT+5
这就是 删除线 (使用波浪号)
斜体
这是用来 *斜体* 的 _文本_Typora: CTRL+I
这是用来 斜体 的 文本
加粗
这是用来 **加粗** 的 __文本__Typora: CTRL+B
这是用来 加粗 的 文本
下划线
这是<u>下划线</u>下划线是HTML语法
Typora: CTRL+U
这是下划线
高亮(需勾选扩展语法)
这是用来 ==高亮标记== 的文本这是用来 高亮标记 的文本
下标(需勾选扩展语法)
水 H~2~O
双氧水 H~2~O~2~水 H2O 双氧水 H2O2
上标(需勾选扩展语法)
面积 m^2^
体积 m^3^面积 m2 体积 m3
表情符号
Markdown 支持 Emoji 表情符号。在 Typora 中按 WIN+. 可调出系统 Emoji 面板,也可以输入 : 触发智能提示选择内置表情代码(如 :smirk:)。
常用的 Emoji 查询工具包括 Unicode 官方完整列表(涵盖所有版本的 Emoji 编码)和 WebFX Emoji 速查表(按分类整理的常用 Emoji)。
Emoji 代码可以与 Markdown 格式混合使用,如 # 标题:smirk: 或 ~~删除线:smirk:~~。
表格
使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行:
name | price
--- | ---
fried chicken | 19
cola|5为了使 Markdown 更清晰,
|和-两侧需要至少有一个空格(最左侧和最右侧的|外就不需要了)。
| name | price |
|---|---|
| fried chicken | 19 |
| cola | 5 |
Typora: CTRL+T 快速插入表格
引用
>"后悔创业""后悔创业"
>也可以在引用中
>>使用嵌套的引用也可以在引用中
使用嵌套的引用
Typora: CTRL+SHIFT+Q
列表
Typora:
CTRL+[ 减少缩进
CTRL+] 增加缩进
无序列表
* 可以使用 `*` 作为标记
+ 也可以使用 `+`
- 或者 `-`- 可以使用
*作为标记
- 也可以使用
+
- 或者
-
Typora: CTRL+SHIFT+]
有序列表
1. 有序列表以数字和 `.` 开始;
3. 数字的序列并不会影响生成的列表序列;
4. 但仍然推荐按照自然顺序(1.2.3...)编写。- 有序列表以数字和
.开始; - 数字的序列并不会影响生成的列表序列;
- 但仍然推荐按照自然顺序(1.2.3...)编写。
Typora: CTRL+SHIFT+[
代码
Markdown 提供多种代码表达形式,包括代码块和行内代码。
代码块
Typora: CTRL+SHIFT+K
```语言名称 public static void main(String[] args) {
}行内代码
Typora: CTRL+SHIFT+`
也可以通过 ``,插入行内代码(` 是 `Tab` 键上边、数字 `1` 键左侧的那个按键):
例如 `Markdown`Markdown
转换规则
代码块中的文本(包括 Markdown 语法)都会显示为原始内容
分隔线
可以在一行中使用三个或更多的 *、- 或 _ 来添加分隔线:
***
------
___跳转
Typora: CTRL+K
外部跳转--超链接
格式为 [link text](link)。
[帮助文档](https://support.typora.io/Links/#faq)内部跳转--本文件内跳(Typora支持)
格式为 [link text](#要去的目的地--标题)。
自动链接
使用 <> 包括的 URL 或邮箱地址会被自动转换为超链接:
<https://www.baidu.com>
<123@email.com>图片
Typora: CTRL+SHIFT+I
适用场景
| 场景 | 推荐用法 | 原因 |
|---|---|---|
| 技术文档 | 标题 + 代码块 + 表格 | 结构清晰,便于阅读 |
| 博客文章 | 标题 + 列表 + 图片 | 排版简洁,专注内容 |
| README 文件 | 标题 + 列表 + 代码块 + 链接 | GitHub/GitLab 原生支持 |
| 笔记系统 | 标题 + 列表 + 双链 | Obsidian/Logseq 等工具支持 |
FAQ
Q: Markdown 和 HTML 有什么区别? A: Markdown 是轻量级标记语言,语法简洁(# 标题、**加粗**),专注于内容本身;HTML 是完整的网页标记语言,标签丰富但冗长。Markdown 适合写文档和笔记,HTML 适合构建网页。Markdown 可以嵌入 HTML 标签(如下划线 <u>),但反过来不行。
Q: Typora 和 VS Code 写 Markdown 有什么区别? A: Typora 是所见即所得编辑器,写完立即看到渲染效果,适合专注写作;VS Code 需要安装 Markdown Preview 插件,分屏预览,适合写代码时顺带写文档。Typora 付费,VS Code 免费。
Q: 代码块的语言标签有什么用? A: 语言标签(如 ```java、```python)告诉渲染器使用哪种语法高亮规则。没有语言标签的代码块不会高亮,可读性差。Obsidian、GitHub、Typora 等工具都支持语法高亮。