Markdown语法学习笔记

Learning Journal
Language, Markdown

Markdown的简要规则

标题

标题作为每一篇文章必需的组成部分，这里首先拿出来说一下。在Markdown中，如果一段文字被定义为标题，只要在这段文字前加#号即可。例如：

1
2
3
# 一级标题
## 二级标题
### 三级标题

效果

一级标题

二级标题

###三级标题

列表

Markdown中的列表和Word，Pages中的一样，分为有序和无序表两种。列表的显示只需在文字前加上*或-；有序表则直接在文字前加1. 2. 3. ，符号和文字之间需要加一个空格。

1
2
3
4
- 无序表 1
* 无序表 2
1. 有序表 1
2. 有序表 2

示例

  • 无序表 1
  • 无序表 2
  1. 有序表 1
  2. 有序表 2

引用

如果文章中有引自别处的句子或段落，就要使用引用的格式。引用是可以嵌套的，只需要在文本前加入>这种尖括号（大于号）即可，文本前有几个>表示当前段落的引用层级，这里也要注意符号和文本间的空格。

1
2
>我引
>>>我再引233

示例

我引

我再引233

图片与链接

插入图片和插入链接的语法很相似，区别在于一个!号，直接上代码

1
2
3
4
插入图片：
![](){images/markdown-170816/yamato.png}
插入链接：
[我的GitHub](github.com/bodang2016)

示例

这里直接拿打伞大姐姐做展示图了，YAAAMAATOOOO！

Yamato

链接示例：My GitHub

粗体 斜体 下划线

Markdown中的粗体斜体也非常简单，用一个*包含一段文本就是斜体语法；用两个*包含就是粗体语法；用<u>和</u>包裹语句就是下划线语法，下面为代码：

1
2
3
*斜体语法*
**粗体语法**
<u>下划线语法</u>

示例

斜体语法
粗体语法
下划线语法

表格

在Markdown中使用表格相对来说就比较累了，实现方式有好几种，但不管哪种方式，以下规则都是通用的。

  • 第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行。
  • 列于列之间用管道符|隔开，原生方式每一行的两边都要有管道符。
  • 第二行可以为不同的列指定对齐方向。默认为左对齐，在-右边加上:就是右对齐。

下面上代码：

1
2
3
4
5
|学号|姓名|分数|
|-|-|-:|
|小明|男|750|
|小红|女|110|
|小陆|男|99|

示例

学号 姓名 分数
小明 男 750
小红 女 110
小陆 男 99

代码框

代码框在负责在文章中优雅地呈现代码，在Markdown中实现也非常简单，我常用的方式有两种：

  • 用` 包裹代码文字，这种方法常用于在一行文字的中间穿插代码
  • 用三个` 包裹代码文字并指定代码类型，这种方法常用于大段的代码

下面上代码：

1
2
3
4
5
6
7
`public static void testFunction()`
​···java
public static void main(String[] args){
  testFunction();
}
​···(此处换成英文字符)

示例

public static void testFunction()

1
2
3
public static void main(String[] args){
   testFunction();
 }

分割线

分割线的语法只需要三个*号，例如

1
2
3
A B C D E
***
F G H I J

示例

A B C D E

F G H I J

小结

到这里，Markdown的日常语法就基本总结完了，在日后的日志中多加练习，配合好写作工具，写起东西来肯定会行云流水。更多的语法可以参考Markdown的官方文档或者写作工具的帮助文档。

Future belongs to the few of us still wiling to get our hands dirty.

Share Comments