Markdown 学习

梦里梦外; 2022-06-13 03:52 317阅读 0赞

# 特殊字符
 在代码区块里面， & 、 < 和 > 会自动转成 HTML 实体.Markdown会将特殊字符自动转换。
 
 ©
 
 AT&T
 
 4 < 5
 ***
 
 # 标题
 第一种标题设置方式Setext，在当前行下一行添加==，或者--，对应一级二级标题：
 
 this is an H1
 ====
 这是H2
 ---
 第二种设置方式atx：在行首加#几级标题加几个#（1-6级）
 # 你好
 ## hello
 ###### 我是六级标题
 ***
 # 引用
 >这是引用部分
 
 >引用内容
 >>二级引用
 >>>我是三级标题
 >
 >我是一级引用
 >在这里仍可以使用其他markdown语法,包括标题、列表、代码区块等：
 > 
 > #include <stdio.h>
 > //这是引用区块代码区域
 *一定要注意缩进*
 
 无序列表使用星号、加号或是减号作为列表标记
 
 * 苹果
 * 香蕉
 * 梨子
 
 有序列表则使用数字接着一个英文句点：
 
 1. 我是第一个
 2. 我是第二个
 3. 我是第三个
 
 列表项目标记通常是放在最左边，但是其实也可以缩进，最多 3 个空格，项目标记后面则一定要接着至少一个空格或制表符；
 
 
 
 列表项目内有引用的情况 > 需要缩进：
 * A list item with a blockquote:
 
 > This is a blockquote
 > inside a list item.
 
 如果要放代码区块的话，该区块就需要缩进两次，也就是 8 个空格或是 2 个制表符：
 * 一列表项包含一个列表区块：
 
 #include<stdio.h>
 int main(){
 printf("Hello,World!\n");
 return 0;
 }
 ***
 # 代码区块
 在行首出现数字-句点-空白，要避免这样的状况，你可以在句点前面加上反斜杠:
 
 1986. What a beautiful day!
 
 1986\.What a beautiful day!
 
 在 Markdown中建立代码区块只要简单地缩进 4 个空格或是 1 个制表符就可以.
 这是一个普通段落：
 
 #include<stdio.h>
 int main(){
 printf("你现在也算了解了基本语法!\n");
 return 0;
 }
 
 一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。
 ***
 你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：
 ____
 减号的分割线是将上一行变为二级标题
 --------
 # 链接
 
 Markdown有：行内式和参考式两种形式的链接语法，但两种的链接文字都是用[方括号]来标记的。
 
 建立一个行内式的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：
 
 This is [an example](http://example.com/ "Title") inline link.
 
 [This link](http://example.net/) has no title attribute.
 
 如果是链接到当前主机资源可以用相对路径：See my [About](/about/) page for details.
 
 参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记：
 
 This is [an example][id] reference-style link.
 
 你也可以选择性地在两个方括号中间加上一个空格：
 
 This is [an example] [id] reference-style link.
 
 接着，在文件的任意处，你可以把这个标记的链接内容定义出来：
 
 [id]: http://example.com/ "Optional Title Here"
 
 链接内容定义的形式为：
 
 方括号（前面可以选择性地加上至多三个空格来缩进），* 里面输入链接文字
 * 接着一个冒号
 * 接着一个以上的空格或制表符
 * 接着链接的网址
 * 选择性地接着 title内容，可以用单引号、双引号或是括弧包着
 
 下面这三种链接的定义都是相同：
 
 [foo]: http://example.com/ "Optional Title Here"
 [foo]: http://example.com/ 'Optional Title Here'
 [foo]: http://example.com/ (Optional Title Here)
 
 隐式链接标记可以省略指定链接标记，此时链接标记等同于链接文字，要用隐式链接标记只要在链接文字后面加上一个空的方括号。
 
 [Google][]
 然后定义链接内容：
 
 [Google]: http://google.com/
 
 链接的定义可以放在文件中的任何一个地方。
 ***
 # 强调
 Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用 标签包围，用两个 * 或 _ 包起来的话，则会被转成 ，例：
 
 *single asterisks*
 _single underscores_
 **double asterisks**
 __double underscores__
 
 __如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号,而且你需要做到开始标签和结束标签匹配。__
 
 ***
 # 代码
 标记一小段行内代码，你可以用反引号把它包起来（`），如：
 
 Use the `printf()` function.
 
 如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段：
 ``There is a literal backtick (`) here.``
 
 代码区段的起始和结束端都可以放入一个空白，起始端后面一个，结束端前面一个，这样你就可以在区段的一开始就插入反引号:\
 A single backtick in a code span: `` ` ``
 
 A backtick-delimited string in a code span: `` `foo` ``
 
 # 图片
 图片的语法和链接很相似，有两种：行内式和参考式\
 **行内式**的语法为：
 * 一个惊叹号 !
 * 接着一个方括号，里面放上图片的替代文字
 * 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字。
 如同下面：
 
 ```
 ![Alt text](/path/to/img.jpg)
 ![Alt text](/path/to/img.jpg "Optional title")
 ```
 
 参考式语法大致如下：
 ```
 ![Alt text][id]
 [id]:url/to/image "Optional title attribute"
 ```
 目前markdown还不支持指定图片的高和宽，如果需要可尝试<img>标签
 
 # 自动链接
 Markdown会自动把尖括号包起来的内容转成链接，常用来处理邮箱和网址。
 <http://example.com>\
 <address@example.com>
 
 # 反斜杠
 Markdown可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用 标签），你可以在星号的前面加上反斜杠：\
 \*literal asterisks\*
 
 Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：
 ```
 \ 反斜线
 ` 反引号
 * 星号
 _ 底线
 {} 花括号
 [] 方括号
 () 括弧
 # 井字号
 + 加号
 - 减号
 . 英文句点
 ! 惊叹号
 ```

效果如下：

# 特殊字符 #

在代码区块里面， & 、 < 和 > 会自动转成 HTML 实体.Markdown会将特殊字符自动转换。

AT&T

4 < 5

--------------------

# 标题 #

第一种标题设置方式Setext，在当前行下一行添加==，或者--，对应一级二级标题：

# this is an H1 #

## 这是H2 ##

第二种设置方式atx：在行首加\#几级标题加几个\#（1-6级）

# 你好 #

## hello ##

###### 我是六级标题 ######

--------------------

# 引用 #

> 这是引用部分

> 引用内容
> 
> > 二级引用
> > 
> > > 我是三级标题
> 
> 我是一级引用 在这里仍可以使用其他markdown语法,包括标题、列表、代码区块等：
> 
> #include <stdio.h>
> //这是引用区块代码区域

一定要注意缩进

无序列表使用星号、加号或是减号作为列表标记

*  苹果
 *  香蕉
 *  梨子

有序列表则使用数字接着一个英文句点：

1.  我是第一个
2.  我是第二个
3.  我是第三个

列表项目标记通常是放在最左边，但是其实也可以缩进，最多 3 个空格，项目标记后面则一定要接着至少一个空格或制表符；

列表项目内有引用的情况 > 需要缩进：

*  A list item with a blockquote:
    
    > This is a blockquote inside a list item.

如果要放代码区块的话，该区块就需要缩进两次，也就是 8 个空格或是 2 个制表符：

* 一列表项包含一个列表区块：
 
 #include<stdio.h>
 int main(){
 printf("Hello,World!\n");
 return 0;
 }

--------------------

# 代码区块 #

在行首出现数字-句点-空白，要避免这样的状况，你可以在句点前面加上反斜杠:

1.  What a beautiful day!

1986.What a beautiful day!

在 Markdown中建立代码区块只要简单地缩进 4 个空格或是 1 个制表符就可以. 这是一个普通段落：

#include<stdio.h>
 int main(){
 printf("你现在也算了解了基本语法!\n");
 return 0;
 }

一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。

--------------------

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

--------------------

## 减号的分割线是将上一行变为二级标题 ##

# 链接 #

Markdown有：行内式和参考式两种形式的链接语法，但两种的链接文字都是用\[方括号\]来标记的。

建立一个行内式的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：

This is [an example][] inline link.

[This link][] has no title attribute.

如果是链接到当前主机资源可以用相对路径：See my About page for details.

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

This is [an example][] reference-style link.

你也可以选择性地在两个方括号中间加上一个空格：

This is [an example][] reference-style link.

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

链接内容定义的形式为：

方括号（前面可以选择性地加上至多三个空格来缩进），\* 里面输入链接文字

*  接着一个冒号
 *  接着一个以上的空格或制表符
 *  接着链接的网址
 *  选择性地接着 title内容，可以用单引号、双引号或是括弧包着

下面这三种链接的定义都是相同：

[foo]: http://example.com/ "Optional Title Here"
    [foo]: http://example.com/ 'Optional Title Here'
    [foo]: http://example.com/ (Optional Title Here)

隐式链接标记可以省略指定链接标记，此时链接标记等同于链接文字，要用隐式链接标记只要在链接文字后面加上一个空的方括号。

[Google][] 然后定义链接内容：

链接的定义可以放在文件中的任何一个地方。

--------------------

# 强调 #

Markdown 使用星号（\*）和底线（\_）作为标记强调字词的符号，被 \* 或 \_ 包围的字词会被转成用 标签包围，用两个 \* 或 \_ 包起来的话，则会被转成 ，例：

single asterisks single underscores double asterisks double underscores

如果你的 \* 和 \_ 两边都有空白的话，它们就只会被当成普通的符号,而且你需要做到开始标签和结束标签匹配。

--------------------

# 代码 #

标记一小段行内代码，你可以用反引号把它包起来（\`），如：

Use the `printf()` function.

如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段： ``There is a literal backtick (`) here.``

代码区段的起始和结束端都可以放入一个空白，起始端后面一个，结束端前面一个，这样你就可以在区段的一开始就插入反引号:  
A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

# 图片 #

图片的语法和链接很相似，有两种：行内式和参考式  
行内式的语法为：

*  一个惊叹号 !
 *  接着一个方括号，里面放上图片的替代文字
 *  接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字。 如同下面：

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

参考式语法大致如下：

![Alt text][id]
    [id]:url/to/image "Optional title attribute"

目前markdown还不支持指定图片的高和宽，如果需要可尝试<img>标签

# 自动链接 #

Markdown会自动把尖括号包起来的内容转成链接，常用来处理邮箱和网址。 [http://example.com][an example]  
[address@example.com][address_example.com]

# 反斜杠 #

Markdown可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用 标签），你可以在星号的前面加上反斜杠： 
\*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\   反斜线
    `   反引号
    * 星号
    _   底线
    {}  花括号
    []  方括号
    ()  括弧
    # 井字号
    + 加号
    - 减号
    .   英文句点
    !   惊叹号

参考文献：

[Markdown 语法说明 (简体中文版)][Markdown _]

[怎样使用Markdown][Markdown]

[an example]: http://example.com/
[This link]: http://example.net/
[Google]: http://google.com/
[address_example.com]: mailto:address@example.com
[Markdown _]: http://wowubuntu.com/markdown/
[Markdown]: http://www.ituring.com.cn/article/23