Markdown语法

Posted on | In |

一、标题

  1. 使用底线

    • 语法：
      一级标题
      ========
      二级标题
      --------
      这种语法只支持2级标题
    • 效果：

  2. 使用#号
    想要设置为标题的文字前面加#来表示
    一个#是一级标题，二个#是二级标题，以此类推。
    支持六级标题。
    注：标准语法一般在#后跟个空格再写文字

    • 语法：
      # 这是一级标题
      ## 这是二级标题
      ### 这是三级标题
      #### 这是四级标题
      ##### 这是五级标题
      ###### 这是六级标题
    • 效果：

二、字体

  1. 语法：
    加粗：**这是加粗的文字**
    倾斜：*这是倾斜的文字*
    斜体加粗：***这是斜体加粗的文字***
    删除线：~~这是加删除线的文字~~
  2. 效果：
    加粗：这是加粗的文字
    倾斜：这是倾斜的文字
    斜体加粗：这是斜体加粗的文字
    删除线：这是加删除线的文字

三、引用

在引用的文字前加>即可。
>这是引用的内容
引用也可以嵌套，如加两个>>三个>>>n个…
貌似可以一直加下去，但没神马卵用

语法：
>这是引用的内容
>>这是引用的内容
>>>这是引用的内容
>>>>这是引用的内容
>>>>>这是引用的内容
效果：

这是引用的内容

这是引用的内容

这是引用的内容

这是引用的内容

这是引用的内容

四、分割线

  1. 语法：
    ---
    ----
    ***
    *****
  2. 效果：

五、图片

  1. Markdown语法
    ![百度](https://www.baidu.com/img/bd_logo1.png ‘’BAIDU’’)

  2. 插件：hexo-asset-image 方法

    1. 在根目录下配置文件_config.yml 中有 post_asset_folder:false改为true。
      这样在建立文件时，Hexo会自动建立一个与文章同名的文件夹，
      这样就可以把与该文章相关的所有资源（图片）都放到那个文件夹里方便后面引用。如这里我放了一张test.jpg的图片。

    2. git bash安装插件：npm install https://github.com/7ym0n/hexo-asset-image –save
      （这是个修改过的插件，经测试无问题），
      使用这个插件来引入图片，
      而不是网上那些方法里说的用传统md语法相对路径的方法。

    3. 插入图片时用这种方式：
      其中test.jpg就是你要引用的图片，我这里就是test.jpg，
      后面的This is an test image是图片描述，可以自己修改。

      1
      {% asset_img test.jpg This is an test image %}

    4. 这样就能成功显示了，测试下吧：hexo cl && hexo g && hexo d

六、超链接

Markdown 支持两种链形式的链接语法：行内式链接和参考式链接。

  1. 行内式链接
    Markdown 中行内式链接的语法是用
    方括号包裹链接文字，后面紧跟着括号包裹的链接地址。
  2. 参考式链接
    Markdown 中参考式链接的语法是
    通过一个标记把要链接的文字和内容相匹配的。
    • 标记语法：
      [链接文字][链接标记]​
      [链接标记]:链接地址 “Title”
      语法说明：
      链接标记可以有字母、数字、空白和标点符号；
      链接标记不区分大小写；
      链接地址可以放在当前文件的任意位置；
      Title 在链接地址后使用单引号、双引号或括号包裹起来，可以省略；
    • 语法：
      万物皆可搜[百度][1]或者[知乎][2]
      下面两行的链接地址可以放在文中任意位置
      [1]:https://www.baidu.com/ “排毒”
      [2]:https://www.zhihu.com/ “知乎”
    • 效果：
      万物皆可搜百度或者知乎
  1. 自动链接
    URL 或邮箱地址使用 <> 包裹起来会被自动转换为超链接。

七、列表

Markdown 语法支持有序列表和无序列表，
有序列表由数字 + 英文句号 + 空格 + 列表内容标记，
无序列表由星号/加号/减号 + 空格 + 列表内容标记。

  1. 有序列表
    • 语法：
      数字 + 英文句号 + 空格 + 列表内容
      1. 语文
      2. 数学
      3. 英语
    • 效果：
  2. 无序列表
    • 语法：
      星号/加号/减号 + 空格 + 列表内容标记
      + 加号标识无序列表
      - 减号标识无序列表
    • 效果：
  • 加号标识无序列表
  • 减号标识无序列表
  1. 嵌套列表
    • 语法：
    • 效果：

  • 第一层列表

    • 第二层列表

      • 第三层列表
        • 第四层列表

    • 有序列表与无序列表也可以互相嵌套使用

    • 效果：

  1. 第一层列表
    • 第二层列表
      1. 第三层列表
        • 第四层列表
      2. 第三层列表
        • 第四层列表

八、表格

姓名 技能 排行
刘备 哭 大哥
关羽 打 二哥
张飞 骂 三弟

九、代码

1
2
3
4
5
6
7
8
def fib(n):
a, b = 0, 1
while a < n:
    print(a, end=' ')
    a, b = b, a+b
print()
	
fib(1000)
1
2
3
4
5
def print_some(length, **age):
    print('年龄：', age)
    print('长度：', length)

print_some(length=18, age1=1, age2=2, age3=3, age4=4, age5=5)

十、流程图

略……

十一、Markdown需要转义的字符

\\ 反斜杠

\` 反引号

\* 星号

\_ 下划线

\{\} 大括号

\[\] 中括号

\(\) 小括号

\# 井号

\+ 加号

\- 减号

\. 英文句号

\! 感叹号

就是想输出什么特殊符号就在前面加 \