Markdown的常用语法 II

HyriKuma

上一篇文章:Markdown的常用语法 I

1. 代码表示

要想把文本中的某个部分以代码的形式表示出来,需要在文本的前后添加各一个反引号`使其被包裹起来。当部分其中本身含有反引号时,则需要前后各添加两个反引号来进行包裹。

1
`markdown`是一种轻量级的标记语言

效果如下:

markdown是一种轻量级的标记语言

而想要把代码块给整段以代码形式表现出来,可以采用围栏式代码块的方式来实现。将需要被代码表示的代码块的前后分别用三个反引号```将代码块给包裹起来,可以在代码块前的反引号后通过指定代码的语言类型来实现代码的语法高亮。

比如:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
private static void searchFile(String fileName, File dir) {
if (dir != null && dir.isDirectory()) {
//得到所有的一级文件对象
File[] files = dir.listFiles();
if (files != null && files.length > 0) {
for (File file : files) {
//遍历当前文件夹内的所有文件和文件夹
if (file.isFile()) {
//如果找到的是文件
if (file.getName().equals(fileName)) {
//判断找到的文件名与要查找的文件名是否一致
System.out.println("所查找的文件路径为:" + file.getAbsolutePath());
try {
Process p = null;
Runtime r = Runtime.getRuntime();
p = r.exec(file.getAbsolutePath());//启动程序
} catch (Exception e) {
e.printStackTrace();
}
}
} else {
searchFile(fileName, file);//如果找到的是文件夹,则继续递归,从当前文件夹开始继续查找
}
}
}
} else {
System.out.println("当前位置不是文件夹");
}
}

2. 添加链接

如果要在文本中添加一段内含链接的链接文本,则需要在前后依次添加一对中括号[]和圆括号(),中括号填入显示的链接文本的内容,圆括号内填入内含的链接,链接后面还可以选择是否带上双引号"包裹的title,title能够在使鼠标悬置在链接文本上时显示。比如要嵌入google的链接到文本中,则写法为:

1
[google](https://www.google.com "title")

效果如下:

google

而如果想直接嵌入可点击的链接,只需要使用尖括号<>将链接包裹起来即可。

1
<https://www.google.com>

效果如下:

https://www.google.com

3. 插入图片

图片插入和链接嵌入的方法类似,只需要在中括号前额外添加一个感叹号!,然后在中括号内写入Alt标签(可以不写),并圆括号内添加图片链接,其中图片链接可以为本地图片,支持填入对应的绝对路径或相对路径,也可以是网络图片,填入对应的网络链接即可。同样链接后可以选择是否填入图片的title。

1
![](images/markdown-2/pic1.jpg)

效果如下:

而如果要让图片并排显示,则对应的markdown写法为:

1
2
![](images/markdown-2/pic2.jpg) | ![](images/markdown-2/pic3.jpg)
---|---

效果如下:

4. 表格语法

要在文章中添加表格,应该使用三个或以上连字符(减号)-作为每列标题的底,并以分隔符|来分隔每列,在编写时单元格不需要完全一致对齐。写法举例:

1
2
3
4
5
| 姓名 | 年龄  | 性别 | 
| --- |-----|-----|
| A | 20 | M |
| B | 19 | F |
| C | 22 | F |

效果如下:

姓名 年龄 性别
A 20 M
B 19 F
C 22 F

而如果分别在标题下连字符的左侧、右侧和两侧添加冒号:,则会使文本对齐到表格左侧、右侧和中间。

5. 其他

如果要使文章缩略展示,需要在被缩略的文本前添加上<!--more-->,这样只有在点开全文内容时被缩略文本才会显示出来。

对于一些被用在markdown语法上的符号,如果要把这些符号本身给显示出来,需要在符号前添加上反斜杠\

而要想在文本中添加删除线,则要在目标文本前后各添加两个波浪号~~

1
这是一个~~错误信息~~

效果如下:

这是一个错误信息

此外,markdown完全支持HTML和CSS格式编写,其在插入图片、嵌入链接、调整字体颜色等方面都能够和markdown进行配合使用。比如直接添加:

1
<font color="red">这是一段红色文本</font>

效果即为:

这是一段红色文本

另外,在hexo中还可以安装Mermaid JS模块,用来画流程图。

    graph TD;
      client1 <--> proxy
      client2 <--> proxy
      client3 <--> proxy
      proxy <--> server

其中,graph 类型可以是 graph、digraph、flowchart、gantt、sequenceDiagram、classDiagram 和 stateDiagram。