Markdown学习笔记

Markdown常用语法学习小结

Posted by on April 25, 2018

We believe that writing is about content, about what you want to say – not about fancy formatting. 我们坚信写作写的是内容,所思所想,而不是花样格式。 — Ulysses for Mac

1.标题

1
2
3
4
5
# 一级标题, 也可以使用====(至少使用两个=)
## 二级标题 也可以使用----(至少使用两个-)
### 三级标题
#### 四级标题
##### 五级标题

2.段落和换行

  • 空行代表段落

  • 若某一行只包含空格和制表符,则该行也会被视为空行

  • 段落内可以使用<br>换行

3.引用

  • >表示引用,eg:

    要有最朴素的生活与最爱搜索的梦想。

  • 区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >,eg:

    《论语》有云:

    “有朋自远方来,不亦乐乎?”

  • 引用的区块内也可使用其他的 Markdown 语法,包括标题、列表、代码区块等,但是每行都要在前面加上对应的引用符号,eg:

开始引用

1
2
3
def print_num(num):
   for i in range(100):
       print(i)
  • 代码块引用方法:三个反引号(反引号位于键盘1的左边,即~键)或者四个空格或者Tab

4.列表

  • Markdown 支持有序列表和无序列表。
  • 无序列表使用星号、加号或是减号作为列表标记
  • 有序列表则使用数字接着一个英文句点:
  • 列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符

5.链接

  • Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。不管是哪一种,链接文字都是用 [方括号] 来标记
  • 行内式:只要在方块括号后面紧接着圆括号并插入网址链接即可, 如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可,例如:
    1
    2
    
    [夜雨微寒的博客](https://xugongli.github.io)
    [夜雨微寒的博客](https://xugongli.github.io, "Soaringsoul's Blog")
    

    效果如下: 夜雨微寒的博客 夜雨微寒的博客 也可以使用相对路径: eg:

    1
    2
    
    [素年锦时](/life)
    [读书笔记](/booknotes)
    

    效果如下: 素年锦时 读书笔记

  • 参考式:

    链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记,

    接着,在文件的任意处,你可以把这个标记的链接内容定义出来:eg:

    1
    2
    
      这是[夜雨微寒][id]的博客
      [id]: https://xugongli.github.io  "夜雨微寒的博客"
    

    效果如下: 这是夜雨微寒的博客

6.强调

Markdown 使用星号*和底线_作为标记强调字词的符号, 被 * 或 _ 包围的字词会被转成用 “<em>” 标签包围, 注意:用两个 * 或 _ 包起来的话, 才会被转成<strong>, 但是如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号 eg:

1
要有最朴素的生活与最遥远的梦想。

效果如下:

要有最朴素的生活与最遥远的梦想 对比: 要有最朴素的生活与最遥远的梦想