Markdown基本语法
现在Markdown编译器和各平台支持情况都不太统一,请验证后使用(Emlog对markdown支持不好,故下面有的项目演示效果不明显,或者是由于模版的关系)
标题(Headings)
要创建标题,请在单词或短语前面添加井号(#)。井号的数量代表了标题的级别。例如,添加三个井号即创建一个三级标题<h3>
。
当井号(#)和标题文本之间没有空格时,各Markdown应用程序的处理方式是不一样的。为兼容性考虑,请在井号和标题文本之间添加一个空格。
和下面对于段落的处理类似,标题行上下要各留一空行
段落
段落之间请使用空白行分隔,且段首不缩进
换行(Line Breaks)
在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行或新行。
粗体(Bold)
要加粗文本,请在单词或短语的前后各添加两个星号(asterisks)。Love **is bold**
-> Love is bold
斜体(Italic)
要用斜体显示文本,请在单词或短语前后添加一个星号(asterisk)。Love *is italic*
-> Love is italic
删除线
在文字前后加两个波纹符号~~此处删除~~
显示效果为此处删除
下划线
在文字前后加html代码:<u>下划线</u>
显示效果为
下划线
块引用(Blockquotes)
要创建块引用,请在段落前添加一个 > 符号。
> Dorothy followed her through many of the beautiful rooms in her castle.
渲染效果如下:
Dorothy followed her through many of the beautiful rooms in her castle.
块引用可以包含多个段落。为段落之间的空白行各添加一个 > 符号。
> Dorothy followed her through many of the beautiful rooms in her castle.
>
> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
渲染效果如下:
Dorothy followed her through many of the beautiful rooms in her castle.
The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用,你需要进行实验以查看哪些元素有效。
有序列表(Ordered Lists)
要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。有序列表可嵌套
1. First item
2. Second item
3. Third item
4. Fourth item
1. First item
1. Second item
8. Third item
3. Fourth item
皆输出为:
- First item
- Second item
- Third item
- Fourth item
无序列表(Unordered Lists)
要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。为兼容起见,请不要在同一个列表中混用不同的分隔符,最好选定一种分隔符并一直用下去。
- First item
- Second item
- Third item
- Fourth item
+ First item
+ Second item
+ Third item
+ Fourth item
* First item
* Second item
* Third item
* Fourth item
皆渲染为:
- First item
- Second item
- Third item
- Fourth item
代码
要将字符串表示为代码,请将其包裹在反引号中,如php 8.1
代码块(Code Blocks)
代码块(Code blocks)通常采用四个空格或一个制表符(Tab)缩进。
1. Open the file.
2. Find the following code block on line 21:
<html>
<head>
<title>Test</title>
</head>
3. Update the title to match the name of your website.
分隔线(Horizontal Rules)
要创建分隔线,请在单独一行上使用三个或多个星号 (*)、破折号 (---) 或下划线 (_) ,并且不能包含其他内容。为保持多平台兼容性,请在分隔线的前后均添加空白行。
链接(Links)
要创建链接,请将链接文本括在方括号中,后面紧跟着括在圆括号中的 URL。
My favorite search engine is [Duck Duck Go](https://duckduckgo.com)
渲染效果为:
My favorite search engine is Duck Duck Go
图片(Images)
要添加图片,首先请添加感叹号(!),然后紧跟着是方括号,方括号中可添加替代文本(alt text,即图片显示失败后显示此文本),最后跟着圆括号,圆括号中添加图片资源的路径或 URL。你可以选择在圆括号中的 URL 之后添加标题(即 title 属性)。也可以直接用img代码
![The San Juan Mountains are beautiful](/images/san-juan-mountains.jpg)
显示效果为:
图片加载失败,故显示的为替代文本
转义字符(Escaping Characters)
要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 \。
* 如果没有开头的反斜杠字符的话,这一行将显示为无序列表。
HTML 标签
大多Markdown应用程序允许你在Markdown格式文本中添加HTML标签。如果你喜欢某些HTML标签胜于Markdown语法的话,这将很有帮助。例如,某些人发现通过HTML标签添加图像更加容易。当你需要更改元素的属性时(例如为文本指定颜色或更改图像的宽度),使用HTML标签更方便些。
如需使用HTML,请将HTML标签添加到Markdown格式文本中即可。
This **word** is bold. This <em>word</em> is italic.
渲染效果如下:
This word is bold. This word is italic.
表格
第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。
列于列之间用分隔符|隔开,原生方式的表格每一行的两边也要有管道符。
第二行还可以为不同的列指定对齐方向。默认为左对齐,在-右边加上:就右对齐。
- 左对齐, :-: 中心对齐,-: 右对齐
|学号|姓名|序号|
|-|-|-|
|小明|男|5|
|小红|女|79|
|小陆|男|192|
渲染效果为
学号 | 姓名 | 序号 |
---|---|---|
小明 | 男 | 5 |
小红 | 女 | 79 |
小陆 | 男 | 192 |
折叠内容
HTML <details>
标签指定了用户可以根据需要打开和关闭的额外细节。例如:
<details> <summary>详情如下</summary>
此处为被折叠的内容
</details>
显示效果为
详情如下
此处为被折叠的内容
- 上一篇: Linux服务器操作命令
- 下一篇: 开源论坛Flarum安装步骤