Hexo 博主的 Markdown 语法宝典


哈喽,大家好!今天我们来聊一个写博客、做笔记的神器——Markdown。无论你是技术大佬还是写作萌新,掌握 Markdown 都能让你的文档排版变得前所未有的轻松和高效。这篇文章会带你过一遍最常用的 Markdown 语法,保证你看完就能上手!

一、Markdown 是个啥?

简单来说,Markdown 就是一种“轻量级标记语言”。创始人是约翰·格鲁伯(John Gruber)。它的理念就是让你用一些简单的符号(比如 *# 等)来标记文本格式,然后它就能转换成漂亮的 HTML、PDF 甚至 Word 文档。

你现在看到的很多网站,比如 GitHub、简书,都在用它。它的文件后缀通常是 .md 或者 .markdown

用 Markdown 写个 “Hello World!” 有多简单?就一行:

# Hello World!

二、文章的骨架:标题

写文章总得有标题吧?在 Markdown 里,用 # 号就能搞定。一个 # 是一级标题,两个是二级,最多可以到六级。# 后面记得加个空格哦。

语法示例

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

显示效果

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

三、文章的血肉:段落和文本样式

段落最简单,直接打字就行。如果想换行,可以在上一行末尾敲两个以上的空格再回车。

我们再来看几种常用的文本样式,让你的文章重点突出!

1. 字体样式

  • 斜体:用一个星号 * 或者下划线 _ 包裹文字。
  • 粗体:用两个星号 ** 或者下划线 __ 包裹文字。
  • 粗斜体:三个星号 *** 或者下划线 ___ 伺候。
语法示例
*这是斜体文字*
_这也是斜体文字_

**这是粗体文字**
__这也是粗体文字__

***这是粗斜体文字***
___这也是粗斜体文字___

2. 分隔线

想在文章里加一条水平线来分割内容?很简单,用三个以上的 *- 或者 _ 就可以了。

语法示例
***
---
___

显示效果


3. 删除线

如果你想表示某些内容“已作废”,可以给它加上删除线。用两个波浪线 ~~ 包裹起来就行。

语法示例
~~这段文字被删除了~~
显示效果

这段文字被删除了

4. 下划线

Markdown 原生语法里没有下划线,不过别担心,我们可以直接借用 HTML 的 <u> 标签。

语法示例
<u>给这段文字加上下划线</u>
```##### 显示效果

<u>给这段文字加上下划线</u>

## 四、让内容井井有条:列表

列表分为无序列表和有序列表,还能嵌套使用,非常灵活。

#### 1. 无序列表

用 `*`、`+` 或者 `-` 加上一个空格,就可以创建一个无序列表项。

##### 语法示例

```markdown
- 列表项一
- 列表项二
- 列表项三

2. 有序列表

数字. 加上一个空格,就可以创建一个有序列表。

语法示例
1. 第一步
2. 第二步
3. 第三步

3. 列表嵌套

想在列表里再加一层列表?没问题,在子列表项前面加 4 个空格或者一个 Tab 就行。

语法示例
1. 水果
    - 苹果
    - 香蕉
2. 蔬菜
    - 青菜
    - 萝卜
显示效果
  1. 水果
    • 苹果
    • 香蕉
  2. 蔬菜
    • 青菜
    • 萝卜

五、引用别人的话:区块

当你想引用一段名言或者别人的观点时,可以使用区块。在段落开头加上 > 和一个空格。

语法示例
> 学的不仅是技术,更是梦想。

区块也可以像套娃一样嵌套使用,用 >>>>> 就行。

语法示例
> 这是最外层
>> 这是第一层嵌套
>>> 这是第二层嵌套
显示效果

这是最外层

这是第一层嵌套

这是第二层嵌套

六、技术文章的灵魂:代码

作为技术文章,怎么能没有代码呢?

1. 行内代码

如果你想在一段话里插入简短的代码片段,比如一个函数名 print(),可以用反引号 ` 把它包起来。

语法示例
我们来聊聊 `print()` 函数的用法。

2. 代码区块

需要展示大段代码时,可以用三个反引号 ``````` 包裹起来,还可以在开头指定语言,实现语法高亮,非常酷!

语法示例
```javascript
$(document).ready(function(){
    alert('Markdown is awesome!');
});
```
显示效果
$(document).ready(function(){
    alert('Markdown is awesome!');
});

七、跳转到别处:链接

在文章中添加超链接非常简单。

语法示例
[链接文字](链接地址)

<!-- 例如 -->
欢迎访问[我的博客](https://www.example.com/)<!-- 也可以直接显示链接地址 -->
<https://www.google.com/>

八、让文章更生动:图片

图文并茂的文章才更吸引人嘛!插入图片的语法和链接很像,只是在最前面多一个感叹号 !

语法示例
![图片的替代文字](图片地址 "可选的标题")

<!-- 例如 -->
![Google Logo](https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png "Google Logo")

如果想控制图片大小,可以借助 HTML 的 <img> 标签。

语法示例
<img src="https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png" width="50%">

九、数据展示好帮手:表格

用 Markdown 创建表格也很直观。

语法示例
| 表头1 | 表头2 | 表头3 |
| :--- | :---: | ----: |
| 左对齐 | 居中 | 右对齐 |
| 单元格 | 单元格 | 单元格 |
  • | 用来分隔单元格。
  • - 用来分隔表头和内容。
  • : 的位置可以控制对齐方式(左、中、右)。
显示效果
表头1 表头2 表头3
左对齐 居中 右对齐
单元格 单元格 单元格

十、一些高级技巧

1. 转义字符

如果你想显示 Markdown 的特殊符号(比如 *#),而不是让它起作用,可以在符号前加一个反斜杠 \

语法示例
你想显示两个星号,而不是粗体,可以这样写: \*\*正常显示星号\*\*

2. 数学公式

写技术文章难免会遇到数学公式。可以用两个美元符号 $$ 包裹 LaTeX 格式的公式。

语法示例
$$
\int_0^1 {x^2} \,{\rm d}x
$$
显示效果

$$
\int_0^1 {x^2} ,{\rm d}x
$$


好啦,以上就是 Hexo 写博客时最常用的一些 Markdown 语法了。是不是感觉很简单?现在就打开你的编辑器,动手试试吧!熟能生巧,相信你很快就能玩转 Markdown,享受高效写作的乐趣!


  目录