Xiaoshier Blog

markdown常用操作

发表于 | 分类于

把 markdown 常用语法: 标题, 强调, 链接, 图片, 列表及嵌套, 代码, 引用,段落和换行, 分隔符, 符号转义, 表格的记录一下，以便后期查阅。

一. 标题

文章段落较多时，可以用标题分段。

1
2
3
4
5
6
7
8
9
10
11
标题1
-----

标题2
=====

# 一级标题 

...

###### 六级标题

二、粗斜体

斜体文本 斜体文本

粗体文本 粗体文本

粗斜体文本 粗斜体文本

1
2
3
4
5
*斜体文本* _斜体文本_

**粗体文本** __粗体文本__

***粗斜体文本*** ___粗斜体文本___

三、链接

小事儿的博客1
小事儿的博客2: https://xiaoshier.github.io/
小事儿的博客3
小事儿的博客4
blog

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
1. 行内式
    [text](url[ "title" ]) title 可选
    <url> 显示 url 并添加链接

    [小事儿的博客1](https://xiaoshier.github.io/ "xiaoshier's blog")  
    小事儿的博客2: <https://xiaoshier.github.io/>  网址链接  

2.参考式

    [text][id] 行内语法
    [id]: url[ "title content"] 链接定义[链接 title 可选]

    [小事儿的博客3][1]{:target="_blank"}   打开新的 tab 页
    [小事儿的博客4][xiaoshier]
    [blog][]

    [1]: https://xiaoshier.guthub.io/ "xiaoshier's blog"
    [xiaoshier]: https://xiaoshier.guthub.io/ "xiaoshier blog"
    [blog]: https://xiaoshier.guthub.io/ 'xiaoshier blog'

四. 图片

图片的显示方法, 就是在链接前面加一个 ! 

1
2
3
4
5
6
7
8
9
10
11
1. 行内
    ![Alt text](/path/to/img.jpg)

    ![Alt text](/path/to/img.jpg "Optional title")

2. 参考式
    ![alt text]
    ![alt text][id]

    [alt text]: url[ "image title"]
    [id]: url[ "image title"]

五. 列表

1. 无序列表

  • 列表文本前使用 [减号+空格]
  • 列表文本前使用 [加号+空格]

  • 列表文本前使用 [星号+空格]

    1
    2
    3
    - 列表文本前使用 [减号+空格]
    + 列表文本前使用 [加号+空格]
    * 列表文本前使用 [星号+空格]

2. 有序列表

  1. 列表前使用 [数字+空格]
  2. 不用担心数字不对，显示的时候我们会自动把这行的 4 纠正为 3

  3. 这里是段落1, 这里是段落1, 这里是段落1,
    这里是段落1, 这里是段落1, 这里是段落1, 这里是段落1, 这里是段落1,
    这里是段落1, 这里是段落1, 这里是段落1, 这里是段落1, 这里是段落1,

    这里是段落2, 前面需要加 4 个空格符号, 才可以有正常的缩进效果

    1
    2
    3
    4
    5
    6
    7
    1. 列表前使用 [数字+空格]
    3. 不用担心数字不对，显示的时候我们会自动把这行的 4 纠正为 3
    4. 这里是段落1, 这里是段落1, 这里是段落1, 
       这里是段落1, 这里是段落1, 这里是段落1, 这里是段落1, 这里是段落1, 
       这里是段落1, 这里是段落1, 这里是段落1, 这里是段落1, 这里是段落1, 

       这里是段落2, 前面需要加 4 个空格符号, 才可以有正常的缩进效果

3. 列表嵌套

所有的嵌套, 前面加 4 个空格符, 用来层级递进

  1. 列表所有元素:
    • 无序列表 A
      1. 无序列表 A 的有序子列表
    • 无序列表 A
      • 无序列表 A 的无序子列表

        这里是用用

  2. 列表里的多段换行:
    前面要加4个空格,
    这样换行, 整体格式不会乱
  3. 列表里引用:

    上面空一行
    前面加四个空格
    后面加两个空格

  4. 列表里的代码块儿:
    上面空一行
前面空8格空格

    1
    2
    fdksa   
    fdsaj

格式如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1. 列出所有元素：(与子集之间不可以有空行)
    - 无序列表元素 A
        1. 元素 A 的有序子列表
    - 前面加四个空格
2. 列表里的多段换行：
    前面必须加四个空格，  
    这样换行，整体的格式不会乱
3. 列表里引用：

> 前面空一行  
> 仍然需要在前面加四个空格

4. 列表里代码段：  
        或者直接空八个，引入代码块
        
    \`\`\`
    前面四个空格，之后按代码\`\`\`语法
    \`\`\`

六. 代码

  1. 代码块儿
    • 使用 ``` ```来包裹代码
    • 使用 4 个空格键
  2. 行内代码
    • 使用 ` `
    • 行内将` 放在代码中，eg: `, 可用多个反引号来开启和结束代码eg: `` ` ``

支持的语言：actionscript, apache, bash, clojure, cmake, coffeescript, cpp, cs, css, d, delphi, django, erlang, go, haskell, html, http, ini, java, javascript, json, lisp, lua, markdown, matlab, nginx, objectivec, perl, php, python, r, ruby, scala, smalltalk, sql, tex, vbscript, xml

效果如下:

  • 行内代码

    Use the printf() function.
    A single backtick in a code span: `
    A backtick-delimited string in a code span: `foo`

  • 代码块儿

    1
    2
    3
    $(document).ready(function () {
        alert('hello world');
    });

七. 引用

上面空一行,
前面空一个空格
这里是引用折行, 上一行后面加 2 个空格

这里是引用新的一段
这是引用折行

前面空 4 个空格, 引用中代码块儿
  • 引用中的列表
    1. 引用中的子列表
      • 列表
        1. 引用中的子列表

书写格式如下:

1
2
3
4
5
6
7
8
9
10
11
12
> 上面空一行,  
  这里是引用折行, 上一行后面加 2 个空格
> 
> 这里是引用新的一段  
  这是引用折行

>      前面空 4 个空格, 引用中代码块儿

>- 引用中的列表
>  1. 引用中的子列表
        - 列表
   2. 引用中的子列表

八. 段落和换行

  1. 段落, 通过一个空行来形成新的段落;

  2. 换行, 在一个段落里, 想强制断行, 在行末尾加 2 个以上空格, 或输入<br />

这里是一个段落, 行1
这是是同一段落, 行2

书写格式如下:

1
2
这是是一个段落, 行1(此处加 2 个空格) 
这里是同一个段落, 行2

九. 分隔符

三个及以上减号 或星号 ,且行内再无其他内容

这里是分隔符

这里是分隔符

书写格式如下:

这里是分隔符(下面要空一行)

---

这里是分隔符

***

十. 符号转义

使用 \ 进行符号转义

\' \" \* \-

十一. 表格

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 |

十二. 注释

[](This is a comment, it will not be included)

参考资料

Markdown 语法说明