简易 Markdown 语法教程
说明
Markdown 是一种“易读易写”的标记语言,它通过一些简单的符号来对文章内容进行排版,作者无需精通HTML、UBB这些标签式的代码语言,就可以对自己的文章进行排版,写出漂亮的文章。本站采用Markdown进行文章的投稿及发布,如果您想在本站发表文章,请确保自己熟练使用该语法。
以下为Markdown的简易教程——
Markdown 简易教程
标题
标题是Markdown中最基本的元素之一,使用方法很简单,只需要使用 井号包覆一个标题文本 即可。如
# 标题文本 #
对应的就是HTML中的 <h1>标题文本</h1>
标签,## 标题文本 ##
对应的是 <h2>标题文本</h2>
。标题影响文章的排版格式与目录,正确、层级式地使用标题可以让文章更加清晰易读。
另外,标题文本后方的井号可以省略,如
### 标题文本
亦可达到相同目的。标题文本最多为
<h6>
,也就是六个井号,超过的部分会被视为 h6 标签。# 美观、标准的写法 #
# h1标题
## h2标题
### h3标题
#### h4标题
##### h5标题
###### h6标题
########## 不管多少个#都是h6标题
分割线
如果你的文章比较长,需要用分割线来分割内容,可以使用 三个以上的减号符 来产生分割线---
。但是分割符号必须与其他内容分隔两行,如果上一行有文本,分割符号将会把上一行的文本视为标题,而不会产生一个分割线。
另外,下划线与星号也具有相同效果,所以
---
___
***
都可以产生分割线。分割线的效果如下:
格式化文本
Markdown可以很容易地格式化某段文本,只需要使用简单的符号包覆想要格式化的文本。但因为本博客使用的是Typecho内置的Markdown解析器,某些MD增强语法并不支持,如果您有其他的需要,可能需要使用HTML语法,请您翻阅至第三页……
斜体字,使用一个星号或者下划线
*斜体*
_斜体_
效果 斜体
粗体字,使用两个星号或者下划线
**粗体**
__粗体__
效果 粗体
粗斜体,三个星号或下划线
***粗斜体***
___粗斜体___
效果 粗斜体
删除线,两个波浪符
~~删除线~~
效果
下划线,两个加号
++下划线++
效果 下划线
(有部分Markdown工具并不支持该语法)
高亮文本,两个等号
==高亮文本==
效果 高亮文本
(有部分Markdown工具并不支持该语法)
代码文本,重音符
`代码文本`
效果
代码文本
复合效果,根据需求来添加标记符
***~~++==当时我就卧了一个槽==++~~***
效果
如果你想在文章中显示标记符号本身,只需要 在符号前面加一个反斜杠 就可以了
示例
\*\*不会变粗的文本\*\*
效果 **不会变粗的文本**
示例
\\ 代表反斜杠本身
效果 \ 代表反斜杠本身
比较特殊的文本,比如尖括号,除了使用
\<
\>
之外,还可以使用html转义符来表示,比如:转义符 | 效果 |
---|---|
< | < |
> | > |
& | & |
` | ` |
超链接
本博客支持链接文本自动转换,如https://blog.clso.fun
就会被自动解析为超链接地址。效果 https://blog.clso.fun
另外,你也可以用方括号将链接地址给包裹起来,这样可以在文本中标注出链接地址。
示例
我的博客是[https://blog.clso.fun]这个地址
效果 我的博客是[https://blog.clso.fun]这个地址
但如果你需要自定义超链接的文本,只需要按照这个格式即可
[超链接的描述](链接地址)
示例
[我的博客](https://blog.clso.fun)
效果 我的博客
图片
配上图片可以让文章更加生动,其实在Markdown里添加图片十分简单,只需要在超链接格式前加一个感叹号即可。示例
![图片描述 可空](图片链接)
![洋葱头耍酷](https://clso.fun/res/onion113.gif)
(因为本站文章会将图片自动居中,所以请勿在图片中插入文字。)
带链接的图片
很简单,多层嵌套即可,如[![点击进入主页](https://clso.fun/res/onion113.gif)](https://blog.clso.fun)
注脚式链接
某些情况下,你的文章内链接可能需要指向同一个链接很多次,这时你就可以在文章的末尾采用注脚式链接。[这是一个注脚链接][1]
![这是一个注脚图片][2]
注脚链接也可以插入到文章内 [我是一个链接][1],就比如这样!
[1]: https://blog.clso.fun/
[2]: https://clso.fun/res/onion113.gif
效果如下:这是一个注脚链接
注脚链接也可以插入到文章内 我是一个链接,就比如这样!
注脚的名称可以用任何字符代替,并不一定得是数字,但必须放置在文章的最末尾。
注脚信息
注脚信息可以在文章内插入一个注脚的内联链接,指向文章末尾的标注信息,可以是来源、URL、或者一小段提醒。它与注脚链接的使用方法十分相似,只不过要在方括号内加一个
^
来进行声明的。如
[^一段注脚信息的内容文本]
,就会自动在文章的末尾添加一段类似 1. 一段注脚信息的内容文本
这样的注释文本,而在你设置注脚的地方会添加一个指向该注释文本的链接。另外,注脚文本也支持通过标识符来自定义注释内容,但是这个标识及内容必须放到文章的末尾才行,使用方法与注释链接基本相同!
注脚信息格式如 [^我是一个注脚信息!]
注脚同样支持URL地址链接 [^https://clso.fun/]
同时注脚信息也支持在下方自定义内容 [^233]
…………
[^233]: 我是一个自定义内容的注脚!但是记得一定要放到文章最末尾!!!
注脚信息格式如 1注脚同样支持URL地址链接 2
同时注脚信息也支持在下方自定义内容 3
PS:其实注脚信息并不能在分页模式下工作,这个演示是我自己写的模拟代码!
所以请勿在开启了分页功能的文章内使用注脚功能!
…………
如果到了文章末尾,就会自动显示下面的注释文本:
- 我是一个注脚信息! ↩
- https://clso.fun/ ↩
- 我是一个自定义内容的注脚!但是记得一定要放到文章最末尾!!! ↩
下一页继续介绍Markdown的高级功能
本作品采用 知识共享署名-相同方式共享 4.0 国际许可协议 进行许可。