未验证 提交 f59acaeb 编写于 作者: Miykael_xxm's avatar Miykael_xxm 🚴

update

上级 94b4664c
......@@ -15,6 +15,11 @@ Markdown 文档从内容到格式,甚至插图,通过键盘就可以通通
因此,它是现行电子邮件标记格式的惯例,虽然它也借鉴了几个早期的标记语言,如:`Setext``Textile` (markup language)、`reStructuredText`。格鲁伯也编写了的 Perl 脚本:`Markdown.pl`,用于把 Markdown 语法编写的内容转换成有效的、结构良好的XHTML或HTML内容,并将左尖括号`<``&`号替换成它们各自的字符实体引用。
**补充阅读**
- [创始人 约翰·格鲁伯(John Gruber) 的 Markdown 语法说明]({{repo_url}}/-/wikis/John_Gruber_Markdown_syntax)
- [GFM Markdown 语法说明]({{repo_url}}/-/wikis/markdown)
</details>
接下来,我们来做个小测试~~~
\ No newline at end of file
......@@ -8,10 +8,4 @@
Markdown 旨在简洁、高效,也由于 Markdown 的易读易写,人们用不同的编程语言实现了多个版本的解析器和生成器。这就导致了目前不同的 Markdown 工具集成了不同的功能(基础功能大致相同),例如流程图与时序图,复杂表格与复杂公式的呈现,比如 GFM Markdown 就支持使用 `Mermaid` 生成图表和流程图。
**补充阅读**
- [创始人 John Gruber 的 Markdown 语法说明]({{repo_url}}/-/wikis/John_Gruber_Markdown_syntax)
- [GFM Markdown 语法说明]({{repo_url}}/-/wikis/markdown)
接下来,我们再来做个小测试~~~
\ No newline at end of file
** :wave: 请点击下方的开始测试按钮 :point_down: :point_down: :point_down: **
** :point_down: :point_down: :point_down: 请点击下方的开始测试按钮 **
(x) 开始测试 {{准备好了吗?让我们来考考你}}
......
#### 段落
在 Markdown 中,段落是由一个以上相连接的行句组成,而一个以上的空行则会切分出不同的段落,一般的段落不需要用空白或行缩排。
在 Markdown 中,段落是由一个以上相连接的行句组成,而一个以上的空行则会切分出不同的段落,一般的段落不需要用空白或行缩排。
> 空行的定义是显示上看起来像是空行,便会被视为空行。
>
> 比如,若某一行只包含空白` `和 tab` `,则该行也会被视为空行
「一个以上相连接的行句组成」这句话其实暗示了 Markdown 允许段落内的强迫断行,这个特性和其他大部分的 text-to-HTML 格式不一样(包括 MovableType 的「Convert Line Breaks」选项),其它的格式会把每个断行都转成 `<br />` 标签。
「一个以上相连接的行句组成」这句话其实暗示了 Markdown 允许段落内的强迫换行,这个特性和其他大部分的 text-to-HTML 格式不一样(包括 MovableType 的「Convert Line Breaks」选项),其它的格式会把每个换行都转成 `<br/>` 标签。
这也就意味着在 Markdown 中,如果需要把一段内容当做段落来显示,则需要保证该段内容上方及下方至少各有一个空行,比如:
......@@ -20,6 +20,8 @@
<details><summary> 点击查看这段文字在 Markdown 中的演示效果 </summary>
<hr>
上面这段内容就会被显示在同一行,效果如下:
这里是段落一
这里是段落二
......
Markdown 使用星号 `*` 和下划线 `-` 作为标记强调字词的符号。
Markdown 使用星号 `*` 和下划线 `_` 作为标记强调字词的符号。
#### 斜体
......
** :wave: 请点击下方的开始测试按钮 :point_down: :point_down: :point_down: **
** :point_down: :point_down: :point_down: 请点击下方的开始测试按钮 **
(x) 开始测试 {{准备好了吗?让我们来考考你}}
......
## 段落
在 Markdown 中,段落是由一个以上相连接的行句组成,而一个以上的空行则会切分出不同的段落,一般的段落不需要用空白或行缩排。
在 Markdown 中,段落是由一个以上相连接的行句组成,而一个以上的空行则会切分出不同的段落,一般的段落不需要用空白或行缩排。
> 空行的定义是显示上看起来像是空行,便会被视为空行。
>
> 比如,若某一行只包含空白` `和 tab` `,则该行也会被视为空行
「一个以上相连接的行句组成」这句话其实暗示了 Markdown 允许段落内的强迫断行,这个特性和其他大部分的 text-to-HTML 格式不一样(包括 MovableType 的「Convert Line Breaks」选项),其它的格式会把每个断行都转成 `<br />` 标签。
「一个以上相连接的行句组成」这句话其实暗示了 Markdown 允许段落内的强迫换行,这个特性和其他大部分的 text-to-HTML 格式不一样(包括 MovableType 的「Convert Line Breaks」选项),其它的格式会把每个换行都转成 `<br />` 标签。
这也就意味着在 Markdown 中,如果需要把一段内容当做段落来显示,则需要保证该段内容上方及下方至少各有一个空行,比如:
......
** :wave: 请点击下方的开始测试按钮 :point_down: :point_down: :point_down: **
** :point_down: :point_down: :point_down: 请点击下方的开始测试按钮 **
(x) 开始测试 {{准备好了吗?让我们来考考你}}
......
......@@ -57,7 +57,7 @@ step3:
step4:
link: '{{chapter_3_issue}}'
# description: "参考式链接"
# description: "参考式链接"
transitions:
events: ['note_events']
action:
......@@ -67,7 +67,7 @@ step4:
step5:
link: '{{chapter_3_issue}}'
description: "添加一个标题"
# description: "添加一个标题"
transitions:
- events: ['note_events']
left: '^#{1,6}\s.+'
......
我们先来看一段示例内容:
**我们先来看一段示例内容**
<https://www.csdn.net>
......
Markdown 支持两种形式的链接语法:行内和参考两种形式。不管是哪一种,链接的文字都是用 [方括号] 来标记。
#### 行内形式链接
#### 行内链接
行内形式的链接是在方块括号后面接括号并插入网址链接即可,如果你还想要加上链接的 alt 提示文字,只要在网址后面,用双引号把 alt 文字包起来即可,其格式为 `[内容](http_url "alt 提示")`,例如:
行内链接的格式是在方块括号后面接括号并插入网址链接,如果你还想要加上链接的 alt 提示文字,只要在网址后面,用双引号把 alt 文字包起来即可,其格式为 `[内容](http_url "alt 提示")`,例如:
```
[ CODE CHINA ](https://codechina.csdn.net/)
......
#### 参考式链接
#### 参考式链接
参考式的链接使用另外一个方括号接在链接文字的括号后面,而在第二个方括号里面要填入用以辨识链接的标签:
参考式的链接使用另外一个方括号接在链接文字的括号后面,而在第二个方括号里面要填入用以辨识链接的标签:
[CODE CHINA] [1]能够结合云原生技术为 开源技术的教学、学习提供一站式学习、练习的引擎,通过教学培训场景
......
......@@ -7,13 +7,13 @@
[1]: https://codechina.csdn.net/courses?utm_source=explore "CODE CHINA 学习广场"
```
链接网址也可以用方括号包起来:
链接网址也可以用尖括号`< >`包起来:
```
[1]: <https://codechina.csdn.net/courses?utm_source=explore> "CODE CHINA 学习广场"
```
你也可以把 alt 属性放到下一行,也可以加一些缩排,网址太长的话,这样会比较好看:
你也可以把 alt 属性放到下一行,也可以加一些缩进,对于较长的网址,这样排版会比较好看:
```
[1]: https://codechina.csdn.net/courses?utm_source=explore
......
让我们来回顾一下**第四章:链接**的知识点吧:
1. 可以使用 `[内容](http_url "alt 提示")` 的形式添加一个链接
2. 可以使用 参考式 的方式添加一个链接,其结构为 `[内容][1]` + `[1]: http_url "alt 提示"` 的组合
2. 可以使用 参考式 的方式添加一个链接,其结构为 `[内容][1]` + `[1]: http_url "alt 提示"` 的组合
##### 在开始新的章节学习之前,请点击下方的 `关闭 Issue` 按钮。
\ No newline at end of file
** :wave: 请点击下方的开始测试按钮 :point_down: :point_down: :point_down: **
** :point_down: :point_down: :point_down: 请点击下方的开始测试按钮 **
(x) 开始测试 {{准备好了吗?让我们来考考你}}
......
** :wave: 准备好了吗?准备好的话请点击下方的开始学习按钮 :point_down: :point_down: :point_down: **
** :point_down: :point_down: :point_down: 准备好了吗?准备好的话请点击下方的开始学习按钮 **
(x) 开始学习 {{太棒了,让我们开始学习新的内容吧}}
......
......@@ -23,7 +23,7 @@ before:
# Task 列表
step1:
link: '{{chapter_4_issue}}'
description: "行内形式链接"
description: "行内链接"
transitions:
events: ['note_events']
action:
......@@ -35,7 +35,7 @@ step1:
step2:
link: '{{chapter_4_issue}}'
description: "参考式链接"
description: "参考式链接"
transitions:
events: ['note_events']
action:
......@@ -47,7 +47,7 @@ step2:
step3:
link: '{{chapter_4_issue}}'
# description: "参考式链接"
# description: "参考式链接"
transitions:
events: ['note_events']
action:
......@@ -63,7 +63,7 @@ step3:
step4:
link: '{{chapter_4_issue}}'
# description: "参考式链接"
# description: "参考式链接"
transitions:
events: ['note_events']
action:
......@@ -73,7 +73,7 @@ step4:
step5:
link: '{{chapter_4_issue}}'
description: "添加链接"
# description: "添加链接"
transitions:
- events: ['note_events']
left: '!?\[.+\]\([a-zA-z]+://[^\s]*\)'
......
#### 行内形式图片
#### 行内图片
行内形式图片的语法格式为`![Alt text](/path/to/img.jpg "Optional title")`,比如:
行内图片的语法格式为`![Alt text](/path/to/img.jpg "Optional title")`,比如:
```
![keyboards](https://img-blog.csdnimg.cn/20210112151738537.jpg "好好学习")
......
#### 参考式图片
#### 参考式图片
参考式图片的语法格式为如下:
参考式图片的语法格式为如下:
```
![Alt text][id]
......
让我们来回顾一下**第五章:图片**的知识点吧:
1. 可以使用 `![Alt text](/path/to/img.jpg "Optional title")`式添加一个图片
2. 可以使用 参考形式 的方式添加一个图片,其结构为 `![内容][1]` + `[1]: image_url "alt 提示"` 的组合
1. 可以使用 `![Alt text](/path/to/img.jpg "Optional title")`式添加一个图片
2. 可以使用 参考样式 的格式添加一个图片,其结构为 `![内容][1]` + `[1]: image_url "alt 提示"` 的组合
##### 在开始新的章节学习之前,请点击下方的 `关闭 Issue` 按钮。
\ No newline at end of file
** :wave: 请点击下方的开始测试按钮 :point_down: :point_down: :point_down: **
** :point_down: :point_down: :point_down: 请点击下方的开始测试按钮 **
(x) 开始测试 {{准备好了吗?让我们来考考你}}
......
......@@ -23,7 +23,7 @@ before:
# Task 列表
step1:
link: '{{chapter_5_issue}}'
description: "行内形式图片"
description: "行内图片"
transitions:
events: ['note_events']
action:
......@@ -35,7 +35,7 @@ step1:
step2:
link: '{{chapter_5_issue}}'
description: "参考式图片"
description: "参考式图片"
transitions:
events: ['note_events']
action:
......@@ -49,7 +49,7 @@ step2:
step3:
link: '{{chapter_5_issue}}'
# description: "参考式链接"
# description: "参考式链接"
transitions:
events: ['note_events']
action:
......@@ -59,7 +59,7 @@ step3:
step4:
link: '{{chapter_5_issue}}'
description: "添加图片"
# description: "添加图片"
transitions:
- events: ['note_events']
left: '!\[.+\]\(.+\)'
......
#### Markdown 的转义
Markdown 支持在下面这些符号前面加上反斜杠来帮助插入普通的符号:
Markdown 支持在下面这些符号前面加上反斜杠来转移,以便在 Markdown 中插入普通的符号:
```
\ 反斜杠
` 反引号
* 星号
_ 线
{} 大括号
[] 方括号
() 括号
# 井
+ 加号
- 减号
. 英文句
! 叹号
_ 下划线
{} 大括号 / 花括号
[] 中括号 / 方括号
() 小括号 / 括号
# 井号
+ 加号
- 减号
. 英文句
! 叹号
```
......@@ -10,7 +10,7 @@
// A code block
打开 CODE CHINA
![电脑](https://source.unsplash.com/100x100/?computers)
![电脑](https://img-blog.csdnimg.cn/20210113112904841.jpeg)
var x =1000;
......@@ -33,7 +33,7 @@
// A code block
打开 CODE CHINA
![电脑](https://source.unsplash.com/100x100/?computers)
![电脑](https://img-blog.csdnimg.cn/20210113112904841.jpeg)
var x =1000;
......
** :wave: 请点击下方的开始测试按钮 :point_down: :point_down: :point_down: **
** :point_down: :point_down: :point_down: 请点击下方的开始测试按钮 **
(x) 开始测试 {{准备好了吗?让我们来考考你}}
......
#### 高亮显示代码段
除了缩进显示代码段之外,Markdown 还支持高亮显示的代码段,创建高亮显示的代码段时,将代码段由带有三个反引号( \`\`\` )的行围起来,并在第一个围栏的末尾标识上语言类型即可,比如:
除了缩进显示代码段之外,Markdown 还支持高亮显示的代码段,在需要高亮的代码块的前后各使用三个反引号( \`\`\` )把中间的代码包裹起来,并在第一个 \`\`\` 的末尾标识上语言类型即可,比如:
```javascript
// A highlighted block
......
高亮代码段需要用三个反引号( \`\`\` )的行围起来,并在第一个围栏的末尾标识上语言类型,请再仔细检查一下你的代码格式~~~
\ No newline at end of file
高亮代码段需要用三个反引号( \`\`\` )的行围起来,并在第一个 \`\`\` 的末尾标识上语言类型,请再仔细检查一下你的代码格式~~~
\ No newline at end of file
** :wave: 请点击下方的开始测试按钮 :point_down: :point_down: :point_down: **
** :point_down: :point_down: :point_down: 请点击下方的开始测试按钮 **
(x) 开始测试 {{准备好了吗?让我们来考考你}}
......
另外,你可以通过添加冒号(`:`),指定每一列的文本对齐方式,比如:
```
| Column 1 | Column 2 |
|:--------:| -------------:|
| centered 文本居中 | right-aligned 文本居右 |
| header 1 | header 2 | header 3 |
|:-------- | :------: | --------:|
| left-aligned 文本居左 | centered 文本居中 | right-aligned 文本居右 |
| `:---` 左侧冒号表示**内容和标题栏**居左对齐 | `:--:` 两端都有冒号表示**内容和标题栏**居中对齐 | `---:` 右侧冒号表示**内容和标题栏**居右对齐 |
```
<details><summary> 点击查看表格对齐效果 </summary>
<hr>
| Column 1 | Column 2 |
|:--------:| -------------:|
| centered 文本居中 | right-aligned 文本居右 |
| header 1 | header 2 | header 3 |
|:-------- | :------: | --------:|
| left-aligned 文本居左 | centered 文本居中 | right-aligned 文本居右 |
| `:---` 左侧冒号表示**内容和标题栏**居左对齐 | `:--:` 两端都有冒号表示**内容和标题栏**居中对齐 | `---:` 右侧冒号表示**内容和标题栏**居右对齐 |
</details>
<br>
......
** :wave: 请点击下方的开始测试按钮 :point_down: :point_down: :point_down: **
** :point_down: :point_down: :point_down: 请点击下方的开始测试按钮 **
(x) 开始测试 {{准备好了吗?让我们来考考你}}
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册