markdown 语法总结

前言

在每一个项目中都会看到有一个README.md文件,用来说明如何初始化创建这个项目。所以了解和学习一下markdown语法也是有必要的呀。下面是总结的基础md语法。

基本符号 * - +. >

基本上所有的markdown标记都是基于这四个符号或组合,需要注意的是,如果以基本符号开头的标记,注意基本符号后有一个用于分割标记符和内容的空格。

标题

前面带#号,后面带文字,分别表示h1-h6,只到h6。

列表

  1. 无序列表
    //形式一
    • a
    • b
    • c
      //形式二
    • d
    • e
    • f
      //形式三
    • g
    • h
    • i
  2. 有序列表
    //正常形式
    1. abc
    2. bcd
    3. cde
      //错序效果
    4. fgh
    5. ghi
    6. hij

列表可以嵌套,使用时在嵌套列表前按 tab 或 空格 来缩进,去控制列表的层数

引用说明区块

引用内容、说明内容。在语句前面加一个 > ,注意是英文的那个右尖括号,注意空格,引用因为是一个区块,理论上是应该什么内容都可以放,比如说:标题,列表,引用等等。

嵌套
> 一级引用
>> 二级引用
>>> 三级引用
>>>> 四级引用
>>>>> 五级引用
>>>>>> 六级引用
效果:

一级引用

二级引用

三级引用

四级引用

五级引用

六级引用

代码块

  1. 少量代码,单行使用,直接用`包裹起来就行了
  2. 大量代码,需要多行使用,用

    ```
    

    包裹起来

    表格

    //例子一
    |123|234|345|
    |:-|:-:|-:|
    |abc|bcd|cde|
    |abc|bcd|cde|
    |abc|bcd|cde|
    //例子二
    |123|234|345|
    |:—|:—:|—:|
    |abc|bcd|cde|
    |abc|bcd|cde|
    |abc|bcd|cde|
    //例子三
    123|234|345
    :-|:-:|-:
    abc|bcd|cde
    abc|bcd|cde
    abc|bcd|cde

上面三个例子的效果一样,由此可得:

  1. 表格的格式不一定要对的非常起,但是为了良好的变成风格,尽量对齐是最好的
  2. 分割线后面的冒号表示对齐方式,写在左边表示左对齐,右边为右对齐,两边都写表示居中