博客现在成了我一个很重要的资料记录点,最近研究的东西都搬到了博客上面,既然是自己的博客,就想装扮的好好看看的,然后就换了主题,换了这个主题,好看是蛮好看的,但是我发现文章目录只支持解析h2和h3,而typecho自带的文章编辑器仅仅支持h1和h2的标题建立。
这下子就麻烦大了,虽然知道typecho支持md的语法写文章,但是每次写完之后还要花时间一个个地方标上md语法的符号就很麻烦(这也是我放弃在github page建立hexo的原因之一),不过现在没办法了,必须要学一下md语法了,之前就看过了,md语法并不难,所以这次既然学了,就简单记录一下一些点吧。【傻子啊你,废话的太多了

【本文仅仅记录我自己写文章的排版语法,不涉及HTML的使用,需要的话去底部参考资料里面找Markdown的介绍查阅】

区块元素

标题

Markdown 有两种标题语法,一种是Setext类,一种是atx类。
Setext类很简单,其实Typecho的文章编辑器就是用这种,就是在句子下面加底线,例子如下

G小R天下第一(此处是最高阶标题,也就是h1)
===========
G小R天下第一(此处是第二届标题,也就是h2)
———————————

值得注意的是,=-没有数量限制,多少个都有效果,不过在typecho,实测最少两个

而Atx类就很简单了,在句子前面加#就完事了,#的个数决定是第几阶的标题(最高6个阶,也就是最高h6),例子如下

# G小R天下第一(h1)
## G小R天下第一(h2)

引用

有时候,看别人的文章会发现比人的语句很精炼很好用,但是又不敢直接复制修改,那么这个时候就可以用引用了,引用很简单,在每一行中加入>就可以了,例子如下:

>G小R天下第一

值得注意的是,一段话引用,如果你把语句切断换行,换了行就必须要在下一行的语句前面加上>,例子如下

>G小R天下第一,
>
>G小R是天

为什么要这么做呢,其实换了行就相当于句子另起了,引用不知道你的引用范围,除非是因为显示范围自动换行,例如这句话太长,在显示的时候显示不完才只需要一个。

列表

Markdown有无序和有序两种列表
无序列表:用星号* 、加号+ 、减号- 作为列表标记(注意符号后面要有空格),例子如下

* G小R最帅  + G小R最帅  - G小R最帅
* G小R最酷  + G小R最酷  - G小R最酷
* G小R最棒  + G小R最棒  - G小R最棒

有序列表:直接数字加上一个小数点即可,例子如下(注意小数点后面的空格):

1. G小R最帅
2. G小R最酷
3. G小R最棒

无论是有序还是无需,在排序符号和序列内容中间没有加空格,都是无效的

✔ * G小R最帅
✖ *G小R最帅 

代码区块

代码分两种,一种是区块,一种是代码行,这里先说区块
Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例子如下

(此处按空格四次)G小R最帅

分割线

一个空行中(无任何内容)用三个以上的星号*、减号-建立一个分隔线。例子如下

***
*****
---------------------------------------

区段元素

字体

·斜体:需要斜体文字的内容左右两边用一个星号*封闭起来
·加粗:需要加粗文字的内容左右两边用两个星号*封闭起来
·斜体加粗:需要斜体加粗文字的内容左右两边用三个星号*封闭起来
·删除线:需要斜体加粗文字的内容左右两边用两个波浪线~封闭起来
例子如下:

*斜体*
**加粗**
***斜体加粗(其实就是斜体和加粗的星号加起来)***
~~删除线~~~

超链接

超链接分两种,一种是行内式,一种是参考式,Typecho文章编辑器自带的是参考式,这里两种方法都记录一下吧

行内式语法:只有一条

[超链接的名称(用于表面显示)](超链接地址 "超链接title")
title可以不加,注意地址和title中间的空格

例:[百度](https://www.baidu.com)

参考式语法:分开两条内容,例子如下

[超链接的名称(用于表面显示)][id] 
[id]: 超链接(冒号后面记得要有括号)

例:[百度][1]
    [1]: https://www.baidu.com

注意,[id]: 超链接 这一条可以放在文章任意地方,不过推荐放在文章结尾

图片

图片语法和超链接大同小异,一样分为行内式和参考式,不过要注意的是,它和超链接不一样的是在语句前加了个!

行内式:只有一条

![alt](图片地址 "title")
alt:显示在图片下的文字,其实就是个图片加个解释。
title:图片的标题,当鼠标移到图片上时显示的内容。和超链接一样,可加可不加

例如:![帅](glog.gxiaorz.top "shuai")

注意:地址和title中间的空格

参考式:分开两条内容,例子如下

![alt][id] 
[id]: 图片超链接(冒号后面记得要有括号)"title"

例:![帅][2]
    [1]: glog.gxiaorz.top "shuai"

注意,[id]: 超链接 这一条可以放在文章任意地方,不过推荐放在文章结尾,注意地址和title中间的空格

表格

表格实际上很简单,其实就是手绘一个表格而已,用符号代替,用|做竖线,换行自动加横线,下面例子详细解释

表头|表头|表头
-|:-:|-:
内容|内容|内容
内容|内容|内容

表头:就不用说了吧,表格头肯定用来注明此列是什么了
第二行:第二行用来分隔表头和内容,还有用来写明整个表格的格式,文字居中居左居右都在此行表明。(此行必须要有)
-:表示没有内容,写多少个都可以
::表格文字默认居左,在-两边加一个:表示此列文字居中,在-右边加一个:表示此列文字居右
例子:

姓名|性别|外貌
--|:--:|--:
小G|男|帅
小小|女|可爱
小R|男|猛
姓名性别外貌
小G
小小
小R

代码

上面写的是代码区块,这里写的是代码行,代码行从来在语句中间插入代码的时候使用,在代码的左右两边加入`即可
例如:

建立数据库:`create database gxr;`

效果:建立数据库:create database gxr;

那么差不多就记录那么多吧,我写完这个文章,多多少少都会写了有其他再记录补充吧。其实在写这个的时候就用了很多md的语法了。。

参考资料

  1. Markdown基本语法
  2. Markdown的github
  3. Markdown官方简体中文教程