Markdown基本语法

介绍

Markdown 是一种轻量级标记语言，创始人为 John Gruber

标题

Atx 样式标题

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

实现效果

我是一级标题

我是二级标题

…
防止破坏目录树, 省略多级标题

Setext 样式标题

# 一级标题

## 二级标题

实现效果

一级标题

二级标题

建议 ‘=’ 与 ‘-’ 长度 >= 3

段落

换行即为一段，emm
第二段

实现效果

换行即为一段，emm
第二段

字体

_斜体_, _斜体_
**加粗**, **加粗**
**_斜体加粗_**, **_斜体加粗_**
～删除线~

实现效果

斜体, 斜体
加粗, 加粗
斜体加粗, 斜体加粗
～删除线~

分割线

---
---

实现效果

建议 ‘=’ 与 ‘-’ 长度 >= 3

列表

无序列表: 使用\*、+、-

- A
  - a

有序列表:

1. A
   1. a

实现效果

无序列表

  • A
    • a

有序列表:

  1. A

引用

> 我是引用

实现效果

我是引用

行内代码

我是`行内代码`

实现效果

我是行内代码

代码块

🈳🈳🈳🈳 我是代码// 使用缩进,Tab 键或 4 个空格 🈳

或

```markdown
包裹着我
```

实现效果

我是代码  // 使用缩进,Tab键或4个空格

或

包裹中

高亮代码块

以 C++为例

```C++
#include <iostream>
int main() {
  std::cout << "hello" << std::endl;
  return 0;
}
```

实现效果

#include <iostream>
int main() {
  std::cout << "hello" << std::endl;
  return 0;
}

链接

[链接名](链接url "鼠标悬浮显示提示信息")

实现效果

Milk

图片

![图片替代文本](图片url)

实现效果

lena

表格

| table  |  A  |   B |
| :----- | :-: | --: |
| line 1 |  1  |   2 |
| line 2 |  1  |   2 |

:-- 左对齐
:--: 居中
--: 右对齐

实现效果

table A B
line 1 1 2
line 2 1 2

其他

Markdown 基本形式：标签+内容, 注意空格！
Markdwon 兼容 HTML， 下划线实现：<u>下划线</u>
Markdown 转义符号:\\
Markdwon 代码块嵌套:

````markdown
外层
    ```markdown
    内层
    ```
````

Markdown 解析效果存在差异

Markdown 的解析效果可能不同

Markdown 的实现不止一种，有兴趣可以参考 Markdown 中文文档

添加图片

使用 GitHub // 网络不好，会显示不出来

需要：

GitHub 账号
大概了解 Git 的基本使用

大概讲解

  1. GitHub 中创建仓库

  2. 本地 Git 与 GitHub 建立连接

  3. 将需要的图片放到仓库中，然后 push 到 GitHub

  4. 查看你的 GitHub 仓库，找到图片，获取图片链接即可使用

本地相对路径

放置在文章自己的目录中。

  • 修改hexo_blog/_config.yml文件

修改post_asset_folder: false为post_asset_folder: true

  • 新建文章hexo new article

此时将会生成article目录和article.md文件，article目录即为图片根目录

此时文件: article/Rola.jpg

对article.md使用方式: ![Rola](Rola.jpg)

Rola

hexo new并不是必须命令，只要有同名目录即可。

本地绝对路径

资源放置在hexo_blog/source/images文件夹中，多级目录也行访问到。

访问方式: ![banner](/images/blog/Takizawa.jpg)
banner

个人看法

可能不是最好的办法，但是它能用。

我使用的 Markdown 编辑器

编辑器: Visual Studio Code

插件： Markdown All in One

其他推荐

comment: