目录 - Table of Contents

说明

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转义符来表示,比如:
转义符效果
&lt;<
&gt;>
&amp;&
&#96;`
不过一般情况下用不到这些特殊的字符,你只需了解即可。

超链接

本博客支持链接文本自动转换,如 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:其实注脚信息并不能在分页模式下工作,这个演示是我自己写的模拟代码!
所以请勿在开启了分页功能的文章内使用注脚功能!

…………
如果到了文章末尾,就会自动显示下面的注释文本:
  1. 我是一个注脚信息!
  2. https://clso.fun/
  3. 我是一个自定义内容的注脚!但是记得一定要放到文章最末尾!!!

下一页继续介绍Markdown的高级功能