Markdown基本语法
补充说明
不知道是不是主题的问题,很多markdown能支持的在转换成html的时候全失效了。
所以以下的语法如果也在此主题无法使用,建议直接使用html的方法,虽然时间成本比较高。
但是目前确实没有很好的解决办法,本人对js和css忘得差不多了,所以没有能力完全审计源代码。
1.标题
标题的等级由#构成,#号越多对应的标题大小越小,就是类似html语法的h1-h6
1 | # 一级标题 |
值得注意的是,#号后面建议跟个空格,某些平台可能不用
效果如下(主题可能重写过,所以效果可能与其他平台略有差异)
:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
2.字体
常用修饰方法就是,粗体和斜体,然后两者结合粗斜体
markdown中,\-
和\*
的用法差不多
1 | *斜体文本* |
效果如下:
斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本
有的时候有点抽风效果可以看图:
3.段落
段落没啥特殊的,一段话写完回车就行,想看着空一点就空一行再写
1 | 这是一个段落 |
1 | 这是一个段落 |
效果1:
这是一个段落
这也是一个段落
效果2:
这是一个段落
这也是一个段落
4.分割线
本文的分割线是因为主题关系所以显示为虚线
*
和-
的组合,多少好像问题不大,但是三个最基本的需求就够了
1 | *** |
效果如下:
over!
5.删除线
删除线跟加粗类似,使用两组~~
组合
1 | ~~删除线~~ |
效果如下:删除线
6.引用
引用使用>
表示,可以嵌套,例如:
1 | >1 |
效果如下:
1
2
3
4
7.脚注
脚注用的相对少一点,就相当于对一个词拎出来单独描述,注解的说法。
例如:
1 | 他说[^秋天]到了。 |
效果如图:
不知道是主题修改了什么,在这个主题下没法显示,但是markdown预览是能看到的
8.列表
列表分为有序和无序
无序可以使用*
,+
,-
三种符号作为标记
1 | * 1 |
效果如下:
- 1
- 2
- 3
- 1
- 2
- 3
- 1
- 2
- 3
而有序列表则通过特定的开头+上.
并空一格实现
1 | 1. 1 |
效果如下:
- 1
- 2
- 3
嵌套列表自然是有序和无序的结合,或者是有序之间的叠加
1 | 1. a |
效果如下:
- a
- aa
- b
- bb
- c
- cc
!
- a
- aa
- b
- bb
- c
- cc
这里可以看到有序之间的嵌套会使得里面的产生变化
9.代码
这个我感觉比较适合突出一个东西,类似加粗的效果,加粗是给文本变得厚重,代码函数或者片段更适合用修改背景色来突出。
此处使用两个反引号`
1 | `hh` |
效果如下:hh
10.链接
图片和超链接的用法都差不多:
1 | [这是一个指向百度的超链接](www.baidu.com) |
但是总体来讲区别不大,效果如下:
这是一个指向百度的超链接
11.表格
markdown的表格由|
来分隔单元格,由-
分隔表头和其他行。
1 | | 表头 | 表头 | |
效果如下:
表头 | 表头 |
---|---|
单元格 | 单元格 |
单元格 | 单元格 |
此外还有表格内文本对齐方式设置:
* -: 设置内容和标题栏居右对齐。
* :- 设置内容和标题栏居左对齐。
* :-: 设置内容和标题栏居中对齐。
效果如下:
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
但是相对而言,markdown的表格功能单一,就连合并单元格都没法操作,如果有此类需要,我们可以植入html代码
1 | <table> |
结语
markdown的语法其实可以和html混用,但是根据不同浏览器和他的内核版本上,显示的效果可能存在差异,所以尽量少用