本文主要包括Markdown的特殊语法，一些还与Hexo的特定Markdown渲染方式有关，在网上不是很方便查找，因此记录下来。

Markdown语法

  • md文件头设置
    1
    2
    3
    4
    title: 标题
    date: YYYY-MM-DD HH:mm
    tags: 分类标签
    toc: true

注1：toc为是否生成目录，默认不生成
注2：Hexo默认按文章时间来排序

  • 添加目录
    混合html代码即可

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    目录位置添加：
    	- [第一章](#1)
    	- [第二章](#2)
    	...

    在相应标题处：
    	<h2 id='1'>第一章</h2>
    	<h2 id='2'>第二章</h2>
    	...
    注：使用html的标题要和后面空一行，否则格式会乱

  • 书写格式
    每一章的大标题用##二级标题，章节内再划分用###，再划分用**加粗即可。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    title：笔记题目  //md自动翻译为一级标题
    ## 1  //每一章节题目是二级标题
    ***   //分隔线
    ### 1.1  //每一章节内部划分，用三级标题

    - **XX**    //章节内每一个知识点用list+加黑的形式划分
    **XX(1)：**  //知识点内再划分就直接加黑，一行可以结束就直接在后面写
    **XX(2)：**

    - **YY**
    **YY(1)：**  //知识点内再划分就直接加黑，一行结束不了就另起
    YY1.1  //不要再写格式了，直接回车划分即可
    YY1.2
    **YY(2)：**
    1、YY2.1  //需要标序号就直接1、2、即可，不要使用有序list语法，否则间距太大很不美观
    2、YY2.2

  • 插入链接/图片

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    插入链接
    [显示文本](链接地址)
    eg : [简书](http://www.jianshu.com)
    页面内跳转也是相同的语法：[显示文本](#相应目录名)

    插入图片
    ![](/images/图片名.xxx)
    将图片直接放到images文件夹下即可。

    若要控制图片大小，使用HTML标签
    <img src="/images/图片名.xxx" width = "300" height = "200" alt="图片名称" align=center />

    在chrome Markdown Preview plus 插件中无法使图片居中，可使用<div>标签
    <div align=center>
    <img src="图片地址" width = "300" height = "300"/><br>
    图x 图片名字
    </div>

  • 插入表格

    1
    2
    3
    4
    5
    6
    | Tables        | Are           | Cool  |
    | ------------- |:-------------:| -----:|
    | col 3 is      | right-aligned | $1600 |
    | col 2 is      | centered      |   $12 |
    | zebra stripes | are neat      |    $1 |
    靠左对齐、居中、靠右对齐

效果：

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

注1：hexo/github的markdown不支持列表list嵌套表格。
注2：一级列表中写表格要空一行（否则表格解析不出来），二级列表中就不要写表格了。
注3：表格内换行，使用html代码<br>

  • 转义符号
    要使用* _ #等符号，但不想被翻译为格式标识符，可在符号前加反斜杠，如\_ \*
    注1：* _为加粗/斜体格式
    注2：markdown中反斜杠和普通字母组合时，如\abc，\不起作用；但反斜杠和特殊字符组合时，如\*，\就会起到转义作用。

零碎记录

  • 分隔线
    三个星号***表示分隔线

  • 插入代码：
    行内代码为前后一个上点，插入代码块是前后三个上点，代码块第一个三点后加C进行语法高亮。

  • 插入空格：
    半角英文空格：&nbsp;
    全角中文空格：&emsp;，注意单词后的分号。

  • 语法高亮
    Hexo语法高亮支持C语言，其他语言也凑合着用C语言的语法高亮吧。

  • VSCode中快捷键ctrl+B添加****，对字体进行加粗

Post Date： 2018-01-19

版权声明： 本文为原创文章，转载请注明出处