1、Markdown 标题
Markdown里有六种标题,均为若干个
#
加空格组成。
Markdown的“标记符”多由“标点符号+空格”组成。该写空格就写,别忘了。
一级标题(最大字号)对应一个 #
号,二级标题对应两个 #
号,以此类推,可实现1-6个级别的标题。
#
后边需要追加一个空格,空格后边即为标题内容。
注:标题应为独立的一行,并且其上、下应各为一个空白行。
语法示例:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
Tips:日常使用 3 - 5 号标题即可。
渲染效果:
你好
2、Markdown 段落
Markdown不同于常规的Word文档,空白行是“切换段落”(分段)用的,并不会渲染成“空行”。因此,在段落后面使用一个空行,以表示重新开始一个段落(推荐)。
也可以在段尾使用“两个以上空格加回车”来实现切换段落(不推荐)。
语法示例1(不分段,仅换行):
我希望有个如你一般的人,如山间清爽的风,如古城温暖的光。
从清晨到夜晚,由山野到书房。只要最后是你,就好。
渲染效果1:
我希望有个如你一般的人,如山间清爽的风,如古城温暖的光。
从清晨到夜晚,由山野到书房。只要最后是你,就好。
语法示例2(进行分段):
我希望有个如你一般的人,如山间清爽的风,如古城温暖的光。
从清晨到夜晚,由山野到书房。只要最后是你,就好。
渲染效果2:
我希望有个如你一般的人,如山间清爽的风,如古城温暖的光。
从清晨到夜晚,由山野到书房。只要最后是你,就好。
3、Markdown 斜/粗 体
文字倾斜:
方法1:用 *
(或 _
)左右包起来即可(推荐)。
方法2:用HTML标签
来实现(不推荐)。
文字加粗:
方法1:用俩 *
(或 _
)左右包起来即可(推荐)。
方法2:也可以用HTML标签
或
来实现(不推荐)。
斜粗体文字:
用仨 *
(或 _
)左右包起来即可。
示例文本:
*斜体文本*
_斜体文本_
HTML斜体文本
**粗体文本**
__粗体文本__
HTML加粗内容示例
HTML加粗文字
***粗斜体文本***
___粗斜体文本___
渲染效果:
斜体文本
斜体文本
斜体文本
粗体文本
粗体文本
加粗内容示例
加粗文字
粗斜体文本
粗斜体文本
4、Markdown 字号/颜色
如果你想指定字号/颜色,可以尝试用html里的
标签来实现。
正常情况下,字号3应最接近默认大小,颜色采用6位16进制数,由前至后分别代表红绿蓝,每种颜色用2位16进制数表示,最终字体颜色效果为RGB的混合色。
示例文本:
<font size="3">三号文字font>
<font size="4">四号文字font>
<font size="5" color="#FF0000">五号红字font>
<font color="#FF0000">红色文字font>
<font color="#FFA500">橙色文字font>
<font color="#FFFF00">黄色文字font>
<font color="#00FF00">绿色文字font>
<font color="#00FFFF">青色文字font>
<font color="#0000FF">蓝色文字font>
<font color="#A020F0">紫色文字font>
<font color="#FFC0CB">粉色文字font>
<font color="#A52A2A">棕色文字font>
渲染效果:
三号文字
四号文字
五号红字
红色文字
橙色文字
黄色文字
绿色文字
青色文字
蓝色文字
紫色文字
粉色文字
棕色文字
对于解析 font
标签中 size
的值,Typora只取出了整数部分。
简记工具提供了快捷键“彩色文字标签”,但这并非最佳方案。下边贴几个常用的标签吧。
渲染示例:橙色文字
渲染示例:蓝色文字
渲染效果:
四号字
5、Markdown 微调字号
这个很少有人在Markdown教程里讲到,需要的时候用一下也不错。
借助HTML标签big/small
,即可微调文字大小。
语法示例:
大号文字
小号文字
渲染效果:
大号文字
小号文字
ChaTi额外扩充了large
标签,以方便微调更大字号,语法示例:
字号增大
注: large
标签仅在ChaTi/轻记内生效,其他任何编辑器都不支持该标签,请谨慎使用。
6、Markdown 删除线
用俩 ~
左右包起来即可,也可以用HTML的
标签来实现(不推荐)。
语法示例:
~~Markdown 删除线内容~~
删除线内容
渲染效果:
Markdown 删除线内容
删除线内容
7、Markdown 下划线
Markdown本身并不提供下划线标签,需要借助HTML的
标签。
语法示例:
下划线文字
渲染效果:
下划线文字
8、Markdown 无序列表
无序列表是一个项目的列表,此列项目使用粗体圆点进行标记。
Markdown无序列表写法非常简单,减号(或加号、星号)加一个空格即可。
注:推荐使用减号,因为星号常用于斜粗体。
语法示例:
- Markdown无序列表
+ Markdown无序列表
* Markdown无序列表
渲染效果:
当然啦,还可以用html的
和
标签来实现(极其复杂,不推荐)。
HTML语法示例:
<ul>
<li>Coffeeli>
<li>Milkli>
ul>
渲染效果:
9、Markdown 有序列表
和无序列表类似,有序列表也是一列项目,列表项目使用数字进行标记。
注:相较于其他文字,列表部分会轻微向右偏移。
Markdown有序列表写法非常简单,数字加小数点,然后加一个空格即可。
语法示例:
1. Markdown有序列表
2. Markdown有序列表
渲染效果:
Markdown有序列表
Markdown有序列表
当然啦,还可以用html的
和
标签来实现(极其复杂,不推荐)。
HTML语法示例:
<ol>
<li>Coffeeli>
<li>Milkli>
ol>
渲染效果:
10、Markdown 嵌套无序列表
无序列表是可以多层嵌套的,在子层列表的行首放两个或更多个空格即可。
语法示例:
- 嵌套列表
- 二级列表
- 三级列表
渲染效果:
来个复杂点的?
语法示例:
- 儒
- 释
- 道
- 书籍
- 道德经
- 著名人物
- 张道陵
- 葛玄
- 萨守坚
- 许旌阳
渲染效果:
当然啦,HTML的也是可以写出来的(太复杂,不推荐)。
HTML语法示例:
<ul>
<li>儒li>
<li>释li>
<li>道
<ul>
<li>书籍
<ul>
<li>道德经li>
ul>
li>
<li>著名人物
<ul>
<li>张道陵li>
<li>葛玄li>
<li>萨守坚li>
<li>许旌阳li>
ul>
li>
ul>
li>
ul>
渲染效果:
11、Markdown 引用
Markdown中通过 >
(大于号)加一个空格实现 引用
。
语法示例:
> 从你的全世界路过
渲染效果:
从你的全世界路过
进阶玩法:
引用
也可以多级嵌套(连续使用多个 >
,加一个空格),而且支持和其它Markdown标签搭配使用,比如无序列表。
语法示例:
> 一级引用文本
>> 二级引用文本
>> - 二级引用,无序列表
>>> 三级引用文本
>>> * 三级引用,无序列表
渲染效果:
一级引用文本
二级引用文本
- 二级引用,无序列表
三级引用文本
- 三级引用,无序列表
12、Markdown 代码
并不一定真要放代码时才能用这个标签,这里举两个例子:
1.如果要重点突出某个字,可以用行内代码标签
2.如果不想让Markdown渲染某段文字,可以用代码块标签进行包裹
Markdown中代码格式化可以通过三种方式:
行内式:通过一对 ` 包裹单行代码/文字实现;
代码块:通过一对 ```包裹实现,可以指定代码的编程语言,如Python、JavaScript、Rust等,如果渲染器支持,将实现语法高亮;
缩进式:通过缩进至少四个空格实现,部分支持语法高亮。
前两个很常用,缩进式写起来很恶心,不推荐。
ChaTi/轻记APP,代码块支持高亮显示,支持标注以下语言:
brainf*ck , c , clike , clojure , cpp , csharp , css , dart , git , go , groovy , java , javascript , json , kotlin , latex , makefile , markdown , markup , python , scala , sql , swift , yaml
注:请使用真实的语言名称(不是别名)。所以,应用 javascript 而不是 js ,应用 markup 而不是 xml 。另外,所有语言名称一律为小写字母。
语法示例:
1.行内式代码: `import os, sys`
2.代码块(无需缩进):
\```python
import os, sys
sys.path
print(os)
\```
3.缩进式:
if (isAwesome){
return true
}
注:为避免标签渲染冲突,代码块标签前面我加了个反斜杠。
渲染效果:
1.行内式代码: import os, sys
2.代码块(无需缩进):
import os, sys
sys.path
print(os)
3.缩进式:
if (isAwesome){
return true
}
13、Markdown 注释
被注释的文字不会显示出来。
正是基于这个特点,衍生出了ChaTi/轻记的“一键复制”功能(后边会重点讲解)。
推荐写法:
[](注释内容,渲染时不会显示)
Markdown中注释可以通过三种方式实现:
1.HTML注释:
用 标签来实现注释;
2.HTML标签:
用HTML标签显示属性 style='display: none'
标签来实现注释;
注:要看编辑器有没有解析div标签。
3.HACK方法:
用Markdown解析原理来实现注释。
注:HACK方法基于Markdown解析原理,相较于HTML注释和HTML标签显示属性要稳定得多,但语义化差(不易阅读)。
Tips:HACK方法注释写法很灵活,基于Markdown解析原理即可。以下实例代码仅试举几例,可自由组合。
语法示例:
HTML注释
HACK方法注释(此处仅是举例,可以利用Markdown解析原理自由组合语法)。
[](我是注释,渲染时不会显示。)
[注释关键字]:(注释描述。)
[#]:<> "我是注释,渲染时不会显示。"
[#]:# "我是注释,渲染时不会显示。"
[注释]:<> "我是注释,渲染时不会显示。"
[注释]:# "我是注释,渲染时不会显示。"
[注释]:// "我是注释,渲染时不会显示。"
[//]:<> "我是注释,渲染时不会显示。"
[//]:# "我是注释,渲染时不会显示。"
渲染效果:
HTML注释
HACK方法注释(此处仅是举例,可以利用Markdown解析原理自由组合语法)。
14、Markdown 任务清单
固定写法,没必要去记,底部给了快捷复制。
语法示例:
- [ ] 未完成
- [x] 已完成
渲染效果:
未完成
已完成
15、Markdown 变量
Markdown 中支持变量定义和变量引用,且支持中文。
一处定义,处处使用,而且方便统一修改。
语法示例:
步骤1.定义链接
[百度]:https://www.baidu.com
步骤2.引用链接:
引用方式:[网站链接][百度]
渲染效果:
步骤1.定义链接[百度]:https://www.baidu.com
步骤2.引用链接:
引用方式:[自定义文本][百度]
16、Markdown 图片
格式:![Alt Text](img url)
这个不需要手写标签,可通过图床工具。
通过简记调用“插图”,即可自动复制Markdown格式的图片标签。
语法示例:
![图片文字描述](http://p.ananas.chaoxing.com/star3/origin/cdb3acda0bd169904d7aa2bb6557383f.jpg?rw=1080&rh=2160&_fileSize=333667&_orientation=0)
渲染效果:
也支持HTML图片标签,顺便贴一下吧。
HTML语法示例:
渲染效果:
17、Markdown 链接
有些Markdown工具不支持自动识别http开头的url链接,用<>
包裹链接即可,如:
渲染效果:
https://xiaobeiit.cn
若需指定url链接文本,格式:[文本](url)
语法示例:
[xiaobeiit](https://xiaobeiit.cn)
渲染效果:
xiaobeiit
18、Markdown 锚点
在纯Markdown环境下一般(自信点,去掉这俩字)是无法生效的,需要在网页内展示。如使用Typora导出为.html文件,或使用CSDN等博客平台。
语法示例:
锚点标题
跳转到此处
渲染效果:
锚点标题
跳转到此处
19、Markdown 表格
语法示例:
| 左对齐 | 居中对齐 | 右对齐 |
| :--| :--: | --: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
渲染效果:
左对齐 | 居中对齐 | 右对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
20、Markdown 特殊字符
语法示例:
空格符:
小于号:<
大于号:>
和号:&
人民币:¥
版权:©
注册商标:®
摄氏度:°
正负号:±
乘号:×
除号:÷
平方(上标²):²
立方(上标³):³
渲染效果:
空格符:
小于号:<
大于号:>
和号:&
人民币:¥
版权:©
注册商标:®
摄氏度:°
正负号:±
乘号:×
除号:÷
平方(上标²):²
立方(上标³):³
注:在空格符的上下方各插入一个空行,即可在渲染时显示空白行。
21、Markdown 对齐文字
Markdown并不提供“居中”等语法标记,需要借助HTML标签来实现。
语法示例:
center标签:
居中文字
align标签:
居中文字
align标签:
右对齐文字
渲染效果:
居中文字
右对齐文字
左对齐
22、Markdown 媒体文件
播放视频代码:
<video id="video" controls="" preload="none" poster="封面图链接"><source id="mp4" src="视频地址" type="video/mp4">video>
播放音频代码:
<audio id="audio" controls="" preload="none"><source id="mp3" src="音频地址">audio>
示例:
23、Markdown 联系方式
Markdown和HTML的链接标签均可,uin即为QQ号。
[QQ联系](http://wpa.qq.com/msgrd?v=3&uin=1653131174&site=qq&menu=yes)
QQ联系
渲染效果:
QQ联系
QQ联系
yun://art.copy/?t=)
发送邮件
mailto参数为收件邮箱,subject参数为邮件主题,a标签参数即为要显示的文本。
渲染效果:
发送邮件