MarkDown入门学习总结教程

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

Markdown的创始人是John Gruber,Markdown作为一种轻量级的「标记语言」,它使我们专心于码字,用「标记」语法,来代替常见的排版格式.
➢段落
一段内容当做一个段落来显示,则需要保证该段内容上方及下方至少各有一个空行(空行含义:某一行只包含空白便会被视为空行)
如何对段落进行换行?
不得不说段落这里是比较绕的哈，了解就行

• 使用两个以上空格键加上回车{敲个回车键}选择题提示:MarkDown中使用回车就可以进行段落的换行为错误说法
  
• 在段落后面使用一个空行来表示重新开始一个段落{敲2个回车,第二个回车写内容代表另起一段}
  
• 在第一行的末尾添加br标签进行换行,就会显示成两段内容{添加br敲回车另起一段}
  

强调说明:
Markdown使用星号*和下划线_作为标记强调字词的符号.
斜体

• 在Markdown中,将内容用*或_包裹起来,包围的字词会被转成用标签包围,会显示成斜体
  
• 如果要在文字前后直接插入普通的星号可以用反斜杠\ *
  
• 如果要在文字前后直接插入普通的_插入下划线\ _
  
• 注意符号连接在一起
  

粗体
用两个*或_包起来就会转换成粗体
删除线
使用两个 ~ 来给内容加上删除线,举例:这个内容是被删掉的
下划线
输入3个星号*或者hr标签
➢标题{Markdown支持两种标题的语法Setext和atx形式}
Setext形式是用底线的形式,利用= (一级标题)和- (二级标题),效果等同h1-h2
举例:注意事项{Setext形式的标题至少需要3个以上的=或_才可以正常显示为标题样式}

1. 标题1
2. =====
3. 标题2
4. -------

复制代码

Atx形式标题,则是在行首插入1到6个#(最多支持6级标题)对应到h1-h6
举例:

1. # 标题1
2. ## 标题2

复制代码

➢链接
Markdown支持两种形式的链接语法:行内和参考形式链接.不管是哪一种,链接的文字都是用[方括号]来标记.
行内形式的链接
在方块括号后面接括号并插入网址链接即可,如果你还想要加上链接的alt提示文字,只要在网址后面,用双引号把alt文字包起来即可.
其格式为内容
例如个人博客
参考形式链接使用另外一个方括号接在链接文字的括号后面,而在第二个方括号里面要填入用以辨识链接的标签
可以使用[内容]:http_url@提示的形式添加一个超链接

注释:个人学习参考形式链接不推荐

↳学过Markdown参考形式图片更正下
可以使用参考样式的方式添加一个链接,其结构为 [内容][1] + [1]: http_url "alt 提示" 的组合
举例:

1. [鬼牛阿飞][wiki]
3. [wiki]: http://www.dhnblog.cn/ "鬼牛阿飞个人博客"

复制代码

代码:

1. [鬼牛阿飞][]
3. [鬼牛阿飞]: http://www.dhnblog.cn/

复制代码

链接的定义可以放在文档中的任何一个地方,建议直接放在链接出现段落的后面,也可以把它放在文档最后面.

➢图片
行内形式图片的语法格式为

1. 

复制代码

注释:刚把百度里面的图片复制修改下,在部分内容编辑器可能提示为:[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-S0buDZ6F-1670403330252)(/path/to/img.jpg "Optional title")]
参考形式图片的语法格式

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

复制代码

举例:

➢列表:Markdown支持有序列表、无序列表和任务列表 三种形式的列表
无序列表使用 * 、 + 或是 - 作为列表标记{符号空格/文字}
有序列表则使用小写数字接着一个英文句号{数字.空格/文字}

1. 当在行首出现数字-句点-空白的内容时，Markdown 会将其当做一个列表进行展示，要避免这样的状况,可以在句点前面加上转义符 \
2. 1987. What a great season.
3. 列表也可以进行嵌套或者与其他 Markdown 内容

复制代码

任务列表的语法格式为 - [ ] text，其中 [ ] (带空格的中括号)表示未完成的任务，x 表示已经完成的任务
代码:

1. - [x] 起床
2. - [x] 吃饭
3. - [ ] 工作
4. - [ ] 睡觉

复制代码

效果:

• 起床
  
• 吃饭
  
• 工作
  
• 睡觉
  

➢分隔线
可以在一行中用三个或以上的、-、_来创建一个分隔线,行内不能有其他东西.你也可以在星号中间插入空白
引用
Markdown 使用 email 形式的区块引用,我们在要引用内容每行的最前面加上 > ,就可以在 Markdown 文档中创建一个区块引用:

• 允许只在整个段落的第一行最前面加上 >
  
• 区块引用可以有级别（例如:引用内的引用）,只要根据级别加上不同数量的 >
  
• 
  

代码:

1. > Perl语言的发明人Larry Wall说,好的程序员有3种美德: 懒惰、急躁和傲慢(Laziness, Impatience and hubris).
2. >
3. > > 程序员有三种美德:懒惰,急躁和傲慢. —— **Larry Wall**
4. >
5. > 懒惰,会使得你花大力气去避免消耗过多的精力.它敦促你写出节省体力的程序,同时别人也能利用它们.为此你会写出完善的文档,以免别人问你太多问题.
6. 急躁,当你发现计算机懒洋洋地不给出结果.于是你写出更优秀的代码,能尽快真正的解决问题.至少看上去是这样.
7. 傲慢,极度的自信,使你有信心写出(或维护)别人挑不出毛病的程序.
8. >

复制代码

效果:

Perl语言的发明人Larry Wall说,好的程序员有3种美德: 懒惰、急躁和傲慢(Laziness, Impatience and hubris).

程序员有三种美德:懒惰,急躁和傲慢. —— Larry Wall

懒惰,会使得你花大力气去避免消耗过多的精力.它敦促你写出节省体力的程序,同时别人也能利用它们.为此你会写出完善的文档,以免别人问你太多问题.
急躁,当你发现计算机懒洋洋地不给出结果.于是你写出更优秀的代码,能尽快真正的解决问题.至少看上去是这样.
傲慢,极度的自信,使你有信心写出(或维护)别人挑不出毛病的程序.

3.引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码块等{支持嵌套}
代码块
行内代码的格式很简单,只需要使用两个 ` 将代码内容包裹起来即可
缩进显示代码{一个代码块会一直持续到没有缩排的那一行(或是文档结尾)}
缩排 4 个空白{空格}或是 1 个 tab 就可以

在代码块里面, & 、 < 和 > 会自动转成 HTML 特殊字符,这样的方式让你非常容易使用 Markdown 插入 HTML 的原始示例代码
就是说在Markdown代码块里面,不用打特殊字符,比方>,原本是>现在直接输入>就可以了.

高亮显示代码段
除了缩进显示代码段之外,Markdown 还支持高亮显示的代码段,创建高亮显示的代码段时,将代码段由带有三个反引号（ ``` ）的行围起来,并在第一个围栏的末尾标识上语言类型即可

1.         ```javascript
2.         // A highlighted block
3.         var foo = 'bar';
4.         ```

复制代码

1. ```javascript
2. // A highlighted block
3. var foo = 'bar';
4. ```

复制代码

当然也可以不指定语言类型{如果```的这个并排显示,效果等于行内代码块``,不过测试题目中提示该语法不正确}

1.         ```
2.         echo "Hello"
3.         ```

复制代码

1. ```
2. echo "Hello"
3. ```

复制代码

Diff 语法{需要注意的是,如果差异内容中包 ,请确保使用反斜杠\ 来转义每个反引号 ,否则差异突出显示将无法正确呈现.}

1.         ```diff
2.         var foo = 'bar';
3.         + var x = 200;
4.         * var x = 100;
5.         ```

复制代码

1. ```diff
2. var foo = 'bar';
3. + var x = 200;
4. * var x = 100;
5. ```

复制代码

更正下如何转义?示例:

1. \`

复制代码

否则展示就是这样式的:Diff 语法{需要注意的是,如果差异内容中包 ,请确保使用反斜杠\ 来转义每个反引号 ,否则差异突出显示将无法正确呈现.}

1. 原本内容其实是:Diff 语法{需要注意的是,如果差异内容中包 `,请确保使用反斜杠\ 来转义每个反引号` ,否则差异突出显示将无法正确呈现.}

复制代码

➢表格
单元格展示为

1. |  |  |
2. |--|--|
3. |  |  |

复制代码

举例为
header1header2header3cell 4cell 5 is longersadasdasdsasadasdsadacell 6 is much longer than the others,
but that’s ok. It will eventually wrap
the text when the cell is too
large for the display size.cell7cell9代码为

1. | header1 | header2 |header3|
2. |---|---|---|
3. |cell 4 | cell 5 is longer |  sadasdas |
4. |dsasad  | asdsada | cell 6 is much longer than the others, <br>but that’s ok. It will eventually wrap<br> the text when the cell is too<br> large for the display size. |
5. |cell7||cell9|

复制代码

语法要求

• 第一行包含表头，并用"竖线"（ | ）分隔
  
• 第二行将标题与单元格分开，并且必须包含三个或更多破折号
  
• 第三行以及随后的任何行均包含单元格值
  

注意事项

不能在 Markdown 中将单元格分隔成多行，它们必须保持为单行，如果需要，还可以使用 HTML
标记对内容进行强制换行
第二行单元长短与标题不需要保持一致，但必须用竖线（|）分隔
可以有空白的单元格

如何设置单元格内文本对齐方式?可以通过添加冒号:的形式{指定每一列的文本对齐方式需要在在第二行添加}
学习Markdown 这里的编辑预览没法展示,换个内容编辑器查看操作下

• :--: 两端都有冒号表示内容和标题栏居中对齐
  
• :--- 左侧冒号表示内容和标题栏居左对齐
  
• ---: 右侧冒号表示内容和标题栏居右对齐
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！