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
=====
标题2
-------Atx形式标题,则是在行首插入1到6个#(最多支持6级标题)对应到h1-h6
举例:
# 标题1
## 标题2➢链接
Markdown支持两种形式的链接语法:行内和参考形式链接.不管是哪一种,链接的文字都是用[方括号]来标记.
行内形式的链接
在方块括号后面接括号并插入网址链接即可,如果你还想要加上链接的alt提示文字,只要在网址后面,用双引号把alt文字包起来即可.
其格式为内容
例如个人博客
参考形式链接使用另外一个方括号接在链接文字的括号后面,而在第二个方括号里面要填入用以辨识链接的标签可以使用[内容]:http_url@提示的形式添加一个超链接
注释:个人学习参考形式链接不推荐
↳学过Markdown参考形式图片更正下
可以使用参考样式的方式添加一个链接,其结构为 内容 + [1]: http_url "alt 提示" 的组合
举例:
[鬼牛阿飞][wiki]
[wiki]: http://www.dhnblog.cn/ "鬼牛阿飞个人博客"代码:
[鬼牛阿飞][]
[鬼牛阿飞]: http://www.dhnblog.cn/链接的定义可以放在文档中的任何一个地方,建议直接放在链接出现段落的后面,也可以把它放在文档最后面.
➢图片
行内形式图片的语法格式为
注释:刚把百度里面的图片复制修改下,在部分内容编辑器可能提示为:[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-S0buDZ6F-1670403330252)(/path/to/img.jpg "Optional title")]
参考形式图片的语法格式
![Alt text][id]
[id]: url/to/image "Optional title attribute"举例:
➢列表:Markdown支持有序列表、无序列表和任务列表 三种形式的列表
无序列表使用 * 、 + 或是 - 作为列表标记{符号空格/文字}
有序列表则使用小写数字接着一个英文句号{数字.空格/文字}
当在行首出现数字-句点-空白的内容时，Markdown 会将其当做一个列表进行展示，要避免这样的状况,可以在句点前面加上转义符 \
1987. What a great season.
列表也可以进行嵌套或者与其他 Markdown 内容任务列表的语法格式为 - [ ] text，其中 [ ] (带空格的中括号)表示未完成的任务，x 表示已经完成的任务
代码:
- [x] 起床
- [x] 吃饭
- [ ] 工作
- [ ] 睡觉效果:
- [x] 起床
- [x] 吃饭
- [ ] 工作
- [ ] 睡觉
➢分隔线
可以在一行中用三个或以上的、-、_来创建一个分隔线,行内不能有其他东西.你也可以在星号中间插入空白
_
引用
Markdown 使用 email 形式的区块引用,我们在要引用内容每行的最前面加上 > ,就可以在 Markdown 文档中创建一个区块引用:
- 允许只在整个段落的第一行最前面加上 >
- 区块引用可以有级别（例如:引用内的引用）,只要根据级别加上不同数量的 >
代码:
> Perl语言的发明人Larry Wall说,好的程序员有3种美德: 懒惰、急躁和傲慢(Laziness, Impatience and hubris).
>
> > 程序员有三种美德:懒惰,急躁和傲慢. —— **Larry Wall**
>
> 懒惰,会使得你花大力气去避免消耗过多的精力.它敦促你写出节省体力的程序,同时别人也能利用它们.为此你会写出完善的文档,以免别人问你太多问题.
急躁,当你发现计算机懒洋洋地不给出结果.于是你写出更优秀的代码,能尽快真正的解决问题.至少看上去是这样.
傲慢,极度的自信,使你有信心写出(或维护)别人挑不出毛病的程序.
>效果:
Perl语言的发明人Larry Wall说,好的程序员有3种美德: 懒惰、急躁和傲慢(Laziness, Impatience and hubris).
程序员有三种美德:懒惰,急躁和傲慢. —— Larry Wall懒惰,会使得你花大力气去避免消耗过多的精力.它敦促你写出节省体力的程序,同时别人也能利用它们.为此你会写出完善的文档,以免别人问你太多问题.
急躁,当你发现计算机懒洋洋地不给出结果.于是你写出更优秀的代码,能尽快真正的解决问题.至少看上去是这样.
傲慢,极度的自信,使你有信心写出(或维护)别人挑不出毛病的程序.
3.引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码块等{支持嵌套}
代码块
行内代码的格式很简单,只需要使用两个 ` 将代码内容包裹起来即可
缩进显示代码{一个代码块会一直持续到没有缩排的那一行(或是文档结尾)}
缩排 4 个空白{空格}或是 1 个 tab 就可以
在代码块里面, & 、 < 和 > 会自动转成 HTML 特殊字符,这样的方式让你非常容易使用 Markdown 插入 HTML 的原始示例代码
就是说在Markdown代码块里面,不用打特殊字符,比方>,原本是>现在直接输入>就可以了.
高亮显示代码段
除了缩进显示代码段之外,Markdown 还支持高亮显示的代码段,创建高亮显示的代码段时,将代码段由带有三个反引号（ ` ）的行围起来,并在第一个围栏的末尾标识上语言类型即可
// A highlighted block
var foo = 'bar';
```// A highlighted block
var foo = 'bar';
```当然也可以不指定语言类型{如果\`\`\`的这个并排显示,效果等于行内代码块\`\`,不过测试题目中提示该语法不正确}
echo "Hello"
```echo "Hello"
```
Diff 语法{需要注意的是,如果差异内容中包 ,请确保使用反斜杠\ 来转义每个反引号 ,否则差异突出显示将无法正确呈现.}
var foo = 'bar';
+ var x = 200;
* var x = 100;
```var foo = 'bar';
+ var x = 200;
* var x = 100;
```更正下如何转义?示例:
\`否则展示就是这样式的:Diff 语法{需要注意的是,如果差异内容中包 ,请确保使用反斜杠\ 来转义每个反引号 ,否则差异突出显示将无法正确呈现.}
原本内容其实是:Diff 语法{需要注意的是,如果差异内容中包 `,请确保使用反斜杠\ 来转义每个反引号` ,否则差异突出显示将无法正确呈现.}➢表格
单元格展示为
| | |
|--|--|
| | |举例为
| header1 | header2 | header3 |
|---|---|---|
| cell 4 | cell 5 is longer | sadasdas |
| dsasad | asdsada | cell 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. |
| cell7 | cell9 |
代码为
| header1 | header2 |header3|
|---|---|---|
|cell 4 | cell 5 is longer | sadasdas |
|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. |
|cell7||cell9|语法要求
- 第一行包含表头，并用"竖线"（ | ）分隔
- 第二行将标题与单元格分开，并且必须包含三个或更多破折号
- 第三行以及随后的任何行均包含单元格值
注意事项
不能在 Markdown 中将单元格分隔成多行，它们必须保持为单行，如果需要，还可以使用 HTML <br>标记对内容进行强制换行
第二行单元长短与标题不需要保持一致，但必须用竖线（|）分隔
可以有空白的单元格
如何设置单元格内文本对齐方式?可以通过添加冒号\:的形式__{指定每一列的文本对齐方式需要在在第二行添加}__
学习Markdown 这里的编辑预览没法展示,换个内容编辑器查看操作下
- :--: 两端都有冒号表示内容和标题栏居中对齐
- :--- 左侧冒号表示内容和标题栏居左对齐
- ---: 右侧冒号表示内容和标题栏居右对齐
