Markdown小知识——链接、代码块、列表

佚名 2022-01-24

1.链接

我们都希望在网页上显示一个网址时,它可以被直接点击而不是需要我们手动将网址复制粘贴到浏览器的地址栏中。下面介绍几种将链接文字转化为可跳转链接的做法。

1.1自动链接

自动链接就是将地址原封不动地显示出来,同时它也将生成该地址的超链接,它常用于邮箱地址和较短网址的显示。操作方法是在该链接地址前后加上一对< >,可见形式如下:

它的显示为:
  https://www.baidu.com

1.2行内链接

行内链接通常用于在一个段落中插入一个链接,同时我们希望链接不要突兀地显示出来影响阅读体验。这时,我们可以为链接起一个介绍名字,将其关联起来,读者可以直接点击该名字就能实现跳转,而不用显示冗长的链接地址。操作方法是在链接别名前后加一对[ ],将紧跟在其后面的链接地址用( )括起来,可见形式如下:

[点我进百度](https://www.baidu.com)

实现效果如下:
 点我进百度

1.3参考链接

参考链接通常用于在全文多处引用某个链接的时候,并且如果该链接很长,我们还像行内链接一样在每次需要使用它的地方就复制粘贴一次,不仅操作很复杂,也看上去很愚蠢。因此我们可以另起一个段落专门用于放置链接和它的别名,然后在全文每次需要这个链接的时候,再对它的别名进行引用,这和论文的参考文献引用十分类似。操作方式如下:

我需要引用百度的网址,点[这里][1]。
[1]:https://www.baidu.com

参考效果如下:
我需要引用百度的网址,点这里。

需要注意的是参考链接必须另起一个段落存放,不然可能会出现问题


2.代码块

2.1行内代码

我们很多时候并不需要大量列出代码,而是进行小范围的展示,并加以文字说明。这时候最推荐使用的是行内代码,它不仅可以插在文字当中作为代码说明,还可以用作关键字等重要的高亮提示。
  使用方法是将所需要展示的代码或者需要高亮的语句用一对 `` 括起来。这个符号是由键盘上数字1旁边的键打出,以下是操作例子和效果显示。
例子:

`print("hello")`
`这是我的`关键词`

效果:
print("hello")
这是我的关键词

2.2多行代码

如果我们想大范围的展示代码,并且使得展示的代码根据不同的语言进行语法高亮,就要选取多行代码块的展示。多行代码块的引用方法是采用一对 ```符号将目标代码括出,并在第一行的的符号后,写明使用何种编程语言的高亮方法。以下是操作实例和效果显示:

2.2.1高亮python代码块:

#!/usr/bin/env python3
print("Hello, World!");

2.2.2高亮C代码块

#include  
int main(void)
{
    printf("Hello world
");
}

2.3缩进式插入

还有一些时候,我们不需要展示代码的语法高亮,我们只想展示最原始的代码,例如,我们在展示markdown操作语法时,不希望浏览器把它解码,而仅仅是把它当成普通文本展示处理,这时候就可以用到缩进式插入。操作方法为:另起一个段落(空出一行,在行首插入Tab键)。

这是缩进式插入。

3.列表

使用列表可以将我们的想法更有条理的表达出来,MarkDown中支持有序列表和无序列表。

3.1无序列表

无序列表使用*,+,-作为列表标记,其语法格式如下:

* 第一项
+ 第二项
- 第三项

展示效果都为:

  • 第一项
  • 第二项
  • 第三项

注:每个符号和文字内容中间一定要空开一个空格的距离

3.2 有序列表

有序列表是使用数字和.来表示,比如:

  1. 第一项
  2. 第二项
  3. 第三项

注:在 . 和文字中间需要空开一个空格的近距离

3.3 列表嵌套

在遇到需要展示二维信息的时候,往往会需要用到列表嵌套,其语法格式表现为在需要嵌套的列表前加上四个空格,例如:

1. 第一项
    - 嵌套第一项
2. 第二项
    - 嵌套第二项

展示效果如下:

  1. 第一项
  2. 嵌套第一项
  3. 第二项
  4. 嵌套第二项




评论: 阅读:
猜你喜欢