Markdown使用笔记
一、段落与强调
important denotes the impossible thing to
do
Because your ugly appearance, you cannot have a happy ending.
-
使用*括起来的为斜体
-
使用**括起来的是粗体
-
使用~~括起来的是删除线
-
在句子后面添加<br>即可换行
二、标题
在行首插入 1 到 6 个 #
(最多支持 6 级标题) ,对应到标题 1 到 6 级。
三、链接
(一)行内形式链接
对应的链接文字使用方括号[ ]进行标记,具体的网站链接使用圆括号进行包裹。
例如:
百度
(二)参考形式链接
参考形式的链接使用另外一个方括号接在链接文字的括号后面,而在第二个方括号里面要填入用以辨识链接的标签,类似于latex中添加的keyword,作为一个标识,用作后面的引用
四、图片
(一)行内图片
替代文本alt text
(二)参考形式图片
到目前为止, Markdown 还没有办法指定图片的宽高,如果需要的话,可以使用普通的标签。
五、列表
(一)无序列表
使用*或者 +或是 -作为标志
- 你好
(二)有序列表
使用阿拉伯数字加上英文句号表示有序列表,例如1.
- 你好
- hi
(三)任务列表
使用- [ ] todo,其中 [ ]
(带空格的中括号)表示未完成的任务,[x]
(带字母x的中括号) 表示已经完成的任务
例如
- do
- not do
六、分割线及引用
(一)分割线
在一行中用三个或以上的*
、-
、_
来创建一个分隔线,行内不能有其他东西。你也可以在星号中间插入空白。
上面的三种符号中任选其一
写法一:连续五个星号*
写法二:连续五个减号
写法三:连续五个下划线
(二)引用
在所要引用的文字前面添加>即为对前面文字的引用。
众所周知,小牛是一名学生
此外,在引用中可以进行二级引用,甚至更多。
众所周知,小牛是一名学生
众所周知,小牛是一名学生
引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码块等:
程序员的三种美德
- 懒惰
- 急躁
- 傲慢
下面是代码的示例:
return shell_exec("echo $input | $markdown_script");
七、代码块
(一)行内代码
行内代码就是在代码的两侧使用``进行包裹即可
#include <iostream>
一个代码块会一直持续到没有缩排的那一行(或是文档结尾)。
在代码块里面, &
、 <
和 >
会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入 HTML 的原始示例代码,例如:
(二)高亮显示代码段
除了缩进显示代码段之外,Markdown 还支持高亮显示的代码段,创建高亮显示的代码段时,将代码段由带有三个反引号( ```)的行围起来,并在第一个围栏的末尾标识上语言类型即可,比如:
def hello_world():
print("Hello, World!")
八、表格
- 第一行包含表头,并用"竖线"( | )分隔
- 第二行将标题与单元格分开,并且必须包含三个或更多破折号
- 第三行以及随后的任何行均包含单元格值
:--:
两端都有冒号表示内容和标题栏居中对齐:---
左侧冒号表示内容和标题栏居左对齐---:
右侧冒号表示内容和标题栏居右对齐
左对齐 | 居中对齐 | 右对齐 |
---|---|---|
apple | banana | cherry |
dog | cat | bird |