Markdown基本语法

一、标题

在文字前加井号 # 表示标题，共支持六级标题。

注：几乎所有语法符号后要跟个空格再接内容

示例：

# 一级标题
## 二级标题
### 三级标题
···以此类推···

二、文字与排版

• 加粗 文本前后各两个*或者两个_是加粗，如**文本**

• 斜体 文本前后各一个*或者一个_是倾斜，如*文本*

• 斜体加粗 文本前后各三个 *

• 删除线 前后各两个 ~

• 文本高亮 HTML标签<mark>可以对文本进行高亮显示，写法：<mark>文本</mark>

• 字体颜色与大小 可以通过<font size=4 color="blue">文本</font>的形式进行自定义。 size可设置为1-7，浏览器默认是3。常用：<font color="blue">文本</font>

注：以上不加空格

更多细节戳此处查看：Markdown进阶：更改字体、颜色、大小、背景色、图片显示。

• 换行 <br/> (<br>···</br>)

可以内嵌Html语法，例如：段落<p></p>(可能不加结束标签也可，但不要依赖这种做法！)、链接<a href="URL名">显示内容</a>、图片<img src="URL名" width="宽度" height="高度" />等

• 空格 $~~~$（长空） 或者在$圈定的里面（公式区）写入 \（短空）

• 引用 在引用的文字前加一个或多个 > 即可，适应屏幕

效果：

引用1

引用2

• 分割线 用三个及以上的 * 或 - 单独成行

---

• 列表

  • 无序列表 用 * 或 - 或 + 都行，后接空格

  • 有序列表 数字加点

    1. list1
    2. list2

  • 嵌套列表 上下两级之间敲两个空格即可

• 代码块 (```) 用括号中的反引号将需要标注的块区域包起来，三个就行（不加括号，自成一行）

  单行代码：前后各用一个 ` 就行

  代码块：

  这里是代码块

  单行代码： 这里是单行代码

  支持语法高亮，在首行 ` 后紧跟着写相应语言即可，如python

• 脚注 用方括号[]和^可以构成一个脚注，可在后方写注释，注释显示在文末

  脚注写法：[^1]
  注释写法：[^1]: Content

  效果： 脚注^[1]

三、插入超链接和图片

1. [超链接名] (超链接地址 "超链接title") 示例：[百度] (http://baidu.com)

2. ![图片名] (图片地址 "图片title") 图片名为下标

3. <URL名> 可点击的链接，也可填入Email地址

注：名和地址之间中间不加空格，title可不加
title与地址间空一格，内容在鼠标悬停于超链接或图片上时显示

当图片保存在本地路径Blog_repo/themes/fluid/source/img时，
引用图片地址为：/img/.../Image_name

四、表格

用管道符 | 来分隔各列，用 ------ (多个) 来创建（隔开）表头。

示例：

| theHead1 | theHead2 | theHead3 | theHead4 |
| -------- | :------- | -------: | :------: |
| 内容1 | 内容2 | 内容3 | 内容4 |
| 内容1 | 内容2 | 内容3 | 内容4 |

theLongHead1	theLongHead2	theLongHead3	theLongHead4
内容1	内容2	内容3	内容4
内容1	内容2	内容3	内容4

| 1 | 2 | 3 | 4 |
| ---- | :---- | ----: | :---: |
| 超长的内容1 | 超长的内容2 | 超长的内容3 | 超长的内容4 |
| 超长的内容1 | 超长的内容2 | 超长的内容3 | 超长的内容4 |

1	2	3	4
超长的内容1	超长的内容2	超长的内容3	超长的内容4
超长的内容1	超长的内容2	超长的内容3	超长的内容4

在分隔行的连字符 - 左侧、右侧或两侧可以加冒号 : 使得该列内容左对齐、右对齐或居中显示，默认（不加冒号时）左对齐。

五、上传

使用 Git Bash 进入博客目录：

hexo clean  清除已存在的（旧的）缓存和静态文件

hexo g  生成静态文件，存于public文件夹内

hexo d  部署到远程服务器（GitHub Pages）

hexo s  在本地浏览器预览（本地显示和远程显示一般是一致的，可用于检查）

README.md可以直接放在Blog_repo/public中。

六、扩展语法

任务列表语法

短横杠 - 加方括号 [ ] （都有空格）
选择（复选框）则用 x 替换方括号中的空格：[x]

效果：

• 这是一个复选框
• 这是一个普通任务项

注意事项

使用hexo-renderer-pandoc渲染器，卸载了hexo自带的marked渲染器后，有些Markdown语法格式与LaTex语法格式冲突，因此需要注意以下几点：

1. 不要在代码块(`划定的区域)中插入公式，会无法解析/渲染
2. 引用>时，或者用其他符号如任务列表语法-[]、标题#时，最好单独成行，前、后各空一行，LaTex会“吃”空格/行
3. 使用公式要在Front-matter中指定："math: true"
4. 加入文章索引需在Front-matter中指定："category_bar: true"
5. 有脚注时，要在文末空个两行，防止脚注紧贴正文，正文格式会影响脚注的显示格式(注释会在文章最后显示)
6. 空一行及以上，渲染结果就是内容之间间隔一行；换行渲染后仅相当于空格；可用<br/>来换行
7. 不要在$后面随意加空格(插入公式时)

1. 这是一个脚注^_^ ↩︎