markdown全教程

博主： Ricken
发布时间：2021 年 09 月 04 日
880次浏览
暂无评论
9192字数
分类：学习笔记 Markdown

一、标题

Markdown里有六种标题，均为若干个 # 加空格组成。

Markdown的“标记符”多由“标点符号+空格”组成。该写空格就写，别忘了。

一级标题（最大字号）对应一个 # 号，二级标题对应两个 # 号，以此类推，可实现1-6个级别的标题。

# 后边需要追加一个空格，空格后边即为标题内容。

注：标题应为独立的一行，并且其上、下应各为一个空白行。

语法示例：

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

Tips：日常使用 3 - 5 号标题即可。

渲染效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

二、段落

Markdown不同于常规的Word文档，空白行是“切换段落”（分段）用的，并不会渲染成“空行”。因此，在段落后面使用一个空行，以表示重新开始一个段落（推荐）。

也可以在段尾使用“两个以上空格加回车”来实现切换段落（不推荐）。

语法示例1（不分段，仅换行）：

我希望有个如你一般的人，如山间清爽的风，如古城温暖的光。
从清晨到夜晚，由山野到书房。只要最后是你，就好。

渲染效果1：

我希望有个如你一般的人，如山间清爽的风，如古城温暖的光。
从清晨到夜晚，由山野到书房。只要最后是你，就好。

语法示例2（进行分段）：

我希望有个如你一般的人，如山间清爽的风，如古城温暖的光。

从清晨到夜晚，由山野到书房。只要最后是你，就好。

渲染效果2：

我希望有个如你一般的人，如山间清爽的风，如古城温暖的光。

从清晨到夜晚，由山野到书房。只要最后是你，就好。

三、斜/粗体

文字倾斜：

方法1：用 * （或 _ ）左右包起来即可（推荐）。

方法2：用HTML标签   来实现（不推荐）。

文字加粗：

方法1：用俩 * （或 _ ）左右包起来即可（推荐）。

方法2：也可以用HTML标签   或   来实现（不推荐）。

斜粗体文字：

用仨 * （或 _ ）左右包起来即可。

示例文本：

*斜体文本*

_斜体文本_

<i>HTML斜体文本</i>

**粗体文本**

__粗体文本__

<b>HTML加粗内容示例</b>

<strong>HTML加粗文字</strong>

***粗斜体文本***

___粗斜体文本___

渲染效果：

斜体文本

HTML斜体文本

粗体文本

HTML加粗内容示例

HTML加粗文字

粗斜体文本

四、字号/颜色

如果你想指定字号/颜色，可以尝试用html里的   标签来实现。

正常情况下，字号3应最接近默认大小。

示例文本：

<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只取出了整数部分，而ChaTi/轻记可精确到小数。

简记工具提供了快捷键“彩色文字标签”，但这并非最佳方案。下边贴几个常用的标签吧。

1.橙色文字：

<font color="#FF7F00"></font>

渲染示例：橙色文字

2.蓝色文字：

<font color="#7093DB"></font>

渲染示例：蓝色文字

3.四号字：

<font size="4"></font>

渲染效果：

四号字

五、微调字号

这个很少有人在Markdown教程里讲到，需要的时候用一下也不错。

借助HTML标签big/small，即可微调文字大小。

语法示例：

<big>大号文字</big><small>小号文字</small>

渲染效果：

大号文字

小号文字

六、删除线

用俩 ~ 左右包起来即可，也可以用HTML的 <s> </s> 标签来实现（不推荐）。

语法示例：

~~Markdown 删除线内容~~<s>HTML 删除线内容</s>

渲染效果：

~~Markdown 删除线内容~~

~~HTML 删除线内容~~

七、下划线

Markdown本身并不提供下划线标签，需要借助HTML的   标签。

语法示例：

<u>下划线文字</u>

渲染效果：

下划线文字

八、无序列表

无序列表是一个项目的列表，此列项目使用粗体圆点进行标记。

Markdown无序列表写法非常简单，减号（或加号、星号）加一个空格即可。

注：推荐使用减号，因为星号常用于斜粗体。

语法示例：

- Markdown无序列表+ Markdown无序列表* Markdown无序列表

渲染效果：

Markdown无序列表

Markdown无序列表

Markdown无序列表

当然啦，还可以用html的 <ul> </ul> 和 <li> </li> 标签来实现（极其复杂，不推荐）。

HTML语法示例：

<ul>    <li>Coffee</li>    <li>Milk</li></ul>

渲染效果：

Coffee
Milk

九、有序列表

和无序列表类似，有序列表也是一列项目，列表项目使用数字进行标记。

注：相较于其他文字，列表部分会轻微向右偏移。

Markdown有序列表写法非常简单，数字加小数点，然后加一个空格即可。

语法示例：

1. Markdown有序列表2. Markdown有序列表

渲染效果：

Markdown有序列表
Markdown有序列表

当然啦，还可以用html的 <ol> </ol> 和 <li> </li> 标签来实现（极其复杂，不推荐）。

HTML语法示例：

<ol>    <li>Coffee</li>    <li>Milk</li></ol>

渲染效果：

Coffee
Milk

十、嵌套无序列表

无序列表是可以多层嵌套的，在子层列表的行首放两个或更多个空格即可。

语法示例：

- 嵌套列表  - 二级列表    - 三级列表

渲染效果：

嵌套列表
- 二级列表
  - 三级列表

来个复杂点的？

语法示例：

- 儒- 释- 道    - 书籍        - 道德经    - 著名人物        - 张道陵        - 葛玄        - 萨守坚        - 许旌阳

渲染效果：

儒
释
道
- 书籍
  - 道德经
- 著名人物
  - 张道陵
  - 葛玄
  - 萨守坚
  - 许旌阳

当然啦，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>

渲染效果：

儒
释
道
- 书籍
  - 道德经
- 著名人物
  - 张道陵
  - 葛玄
  - 萨守坚
  - 许旌阳

十一、引用

Markdown中通过 > （大于号）加一个空格实现 引用 。

语法示例：

> 从你的全世界路过

渲染效果：

从你的全世界路过

进阶玩法

引用 也可以多级嵌套（连续使用多个 >，加一个空格），而且支持和其它Markdown标签搭配使用，比如无序列表。

语法示例：

> 一级引用文本>> 二级引用文本>> - 二级引用，无序列表>>> 三级引用文本>>> * 三级引用，无序列表

渲染效果：

一级引用文本

二级引用文本

二级引用，无序列表

三级引用文本

三级引用，无序列表

十二、代码

并不一定真要放代码时才能用这个标签，这里举两个例子：

1.如果要重点突出某个字，可以用行内代码标签

2.如果不想让Markdown渲染某段文字，可以用代码块标签进行包裹

Markdown中代码格式化可以通过三种方式：

行内式：通过一对 ` 包裹单行代码/文字实现；

代码块：通过一对 ``` 包裹实现，可以指定代码的编程语言，如Python、JavaScript、Rust等，如果渲染器支持，将实现语法高亮；

缩进式：通过缩进至少四个空格实现，部分支持语法高亮。

前两个很常用，缩进式写起来很恶心，不推荐。

代码块支持高亮显示，支持标注以下语言：

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.代码块（无需缩进）：\``` pythonimport os, syssys.pathprint(os)\```3.缩进式：    if (isAwesome){      return true    }

注：为避免标签渲染冲突，代码块标签前面我加了个反斜杠。

渲染效果：

1.行内式代码： import os, sys

2.代码块（无需缩进）：

import os, syssys.pathprint(os)

3.缩进式：

if (isAwesome){  return true}

十三、注释

被注释的文字不会显示出来。

推荐写法：

[](注释内容，渲染时不会显示)

后边的不用看了，使用率很低很低。

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解析原理自由组合语法）。

十四、任务清单

固定写法，没必要去记。

语法示例：

- [ ] 未完成- [x] 已完成

渲染效果：

[ ] 未完成
[x] 已完成

十五、变量

Markdown 中支持变量定义和变量引用，且支持中文。

一处定义，处处使用，而且方便统一修改。

变量定义：[key]:value
变量引用：[key]、[text][key]

语法示例：

步骤1.定义链接[KK博客]:https://kk.hackerjk.top步骤2.引用链接：(1) key引用方式：[KK博客](2) value引用方式：[自定义文本][KK博客]

渲染效果：

步骤1.定义链接

步骤2.引用链接：

(1) key引用方式：KK博客

(2) value引用方式：自定义文本

食用方法：

可将定义变量的文字扔到文章底部，在需使用该变量的位置，插入调用标签（第一个中括号里填写要显示的文字）。

十六、图片

格式：![Alt Text](img url)

语法示例：

![图片文字描述](https://static-upyun.ricken.cn/Web/icons/Blog/2233.png)

渲染效果：

图片文字描述

也支持HTML图片标签，顺便贴一下吧。

HTML语法示例：

<img src = 'https://static-upyun.ricken.cn/Web/icons/Blog/2233.png' />

渲染效果：

十七、链接

有些Markdown工具不支持自动识别http开头的url链接，用<>包裹链接即可，如：

<https://kk.hackerjk.top>

渲染效果：

https://kk.hackerjk.top

若需指定url链接文本，格式：[文本](url)

语法示例：

[kk](https://kk.hackerjk.top)

渲染效果：

十八、锚点

在纯Markdown环境下一般（自信点，去掉这俩字）是无法生效的，需要在网页内展示。如使用Typora导出为.html文件，或使用CSDN等博客平台。

语法示例：

<a href="#标记">锚点标题</a><a id="标记">跳转到此处</a>

渲染效果：

锚点标题

跳转到此处

没思路在不依赖网页时实现该功能，如果确实有需要，建议用Typora导出成html文件。

十九、表格

语法示例：

| 左对齐 | 居中对齐 | 右对齐 || :-----| :----: | ----: || 单元格 | 单元格 | 单元格 || 单元格 | 单元格 | 单元格 || 单元格 | 单元格 | 单元格 || 单元格 | 单元格 | 单元格 |

渲染效果：

左对齐	居中对齐	右对齐
单元格	单元格	单元格
单元格	单元格	单元格
单元格	单元格	单元格
单元格	单元格	单元格

不是很建议大家使用表格，编辑过程很繁琐。

二十、特殊字符

语法示例：

空格符：&nbsp;小于号：&lt;大于号：&gt;和号：&amp;人民币：&yen;版权：&copy;注册商标：&reg;摄氏度：&deg;正负号：&plusmn;乘号：&times;除号：&divide;平方（上标²）：&sup2;立方（上标³）：&sup3;

渲染效果：

空格符：
小于号：<
大于号：>
和号：&
人民币：¥
版权：©
注册商标：®
摄氏度：°
正负号：±
乘号：×
除号：÷
平方（上标²）：²
立方（上标³）：³

注：在空格符的上下方各插入一个空行，即可在渲染时显示空白行。

二十一、对齐文字

Markdown并不提供“居中”等语法标记，需要借助HTML标签来实现。

语法示例：

center标签：<center>居中文字</center>align标签：<p align=center>居中文字</p>align标签：<p align=right>右对齐文字</p>

渲染效果：

center标签：

居中文字

align标签：

居中文字

align标签：

右对齐文字

二十二、媒体文件

播放视频代码：

<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>

由于 ChaTi/轻记使用TextView（文本框）进行渲染，难以插入视频、音频这种媒体文件，所以请考虑用跳到链接的方式单独播放。

示例：

MP3音频-追光者

当然，可能会直接调用下载器来下载该文件。即便能在WebView（浏览器组件）内直接播放音频，安卓原生界面也着实“一言难尽”。

二十三、联系方式

QQ聊天

Markdown和HTML的链接标签均可，uin即为QQ号。

[QQ联系](http://wpa.qq.com/msgrd?v=3&uin=1942113505&site=qq&menu=yes)<a target="_blank" href="http://wpa.qq.com/msgrd?v=3&uin=1942113505&site=qq&menu=yes">QQ联系</a>

渲染效果：

QQ联系

邮件反馈

因为 ChaTi/轻记自定义了链接协议和解析流程，所以此处只使用HTML标签，避免参数丢失。

<a target="_blank" href="mailto:1942113505@gmail.com?subject=KK">发送邮件</a>

mailto参数为收件邮箱，subject参数为邮件主题，a标签参数即为要显示的文本。

渲染效果：

发送邮件

END

本文作者： Ricken
文章标题：markdown全教程
本文地址：https://kk.hackerjk.top/study/markdown.html
版权说明：若无注明，本文皆由小陈的小角落原创，转载请保留文章出处。

最后修改：2022 年 05 月 19 日 05 : 45 PM

要不？请我吃一下沙县连锁大酒店？

发表评论取消回复

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

解锁网易云灰色音乐--Win篇
浏览次数: 20678
你好呀
浏览次数: 9040
Navicat安装教程
浏览次数: 5047
Typecho博客迁移
浏览次数: 3979
记录一次开发新拟态天气DIV的过程
浏览次数: 3943

22攻略
非常感谢你分享这篇文章，我从中学到了很多新的知识。
DuckXu
该评论仅登录用户及评论双方可见
陈咩
原来博主是个emo怪
Dany
大佬可以用了，太谢谢了，好人一生平安！身体健康！吉祥如意！福如...
Dany
我刚刚下载了2.9.7版本的，第一次进入可以使用了，我为了登录...

markdown全教程

Ricken • 2021 年 09 月 04 日

一、标题

Markdown里有六种标题，均为若干个 # 加空格组成。

Markdown的“标记符”多由“标点符号+空格”组成。该写空格就写，别忘了。

一级标题（最大字号）对应一个 # 号，二级标题对应两个 # 号，以此类推，可实现1-6个级别的标题。

# 后边需要追加一个空格，空格后边即为标题内容。

注：标题应为独立的一行，并且其上、下应各为一个空白行。

语法示例：

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

Tips：日常使用 3 - 5 号标题即可。

渲染效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

二、段落

也可以在段尾使用“两个以上空格加回车”来实现切换段落（不推荐）。

语法示例1（不分段，仅换行）：

我希望有个如你一般的人，如山间清爽的风，如古城温暖的光。
从清晨到夜晚，由山野到书房。只要最后是你，就好。

渲染效果1：

我希望有个如你一般的人，如山间清爽的风，如古城温暖的光。
从清晨到夜晚，由山野到书房。只要最后是你，就好。

语法示例2（进行分段）：

我希望有个如你一般的人，如山间清爽的风，如古城温暖的光。

从清晨到夜晚，由山野到书房。只要最后是你，就好。

渲染效果2：

我希望有个如你一般的人，如山间清爽的风，如古城温暖的光。

从清晨到夜晚，由山野到书房。只要最后是你，就好。

三、斜/粗体

文字倾斜：

方法1：用 * （或 _ ）左右包起来即可（推荐）。

方法2：用HTML标签   来实现（不推荐）。

文字加粗：

方法1：用俩 * （或 _ ）左右包起来即可（推荐）。

方法2：也可以用HTML标签   或   来实现（不推荐）。

斜粗体文字：

用仨 * （或 _ ）左右包起来即可。

示例文本：

*斜体文本*

_斜体文本_

<i>HTML斜体文本</i>

**粗体文本**

__粗体文本__

<b>HTML加粗内容示例</b>

<strong>HTML加粗文字</strong>

***粗斜体文本***

___粗斜体文本___

渲染效果：

斜体文本

HTML斜体文本

粗体文本

HTML加粗内容示例

HTML加粗文字

粗斜体文本

四、字号/颜色

如果你想指定字号/颜色，可以尝试用html里的   标签来实现。

正常情况下，字号3应最接近默认大小。

示例文本：

<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只取出了整数部分，而ChaTi/轻记可精确到小数。

简记工具提供了快捷键“彩色文字标签”，但这并非最佳方案。下边贴几个常用的标签吧。

1.橙色文字：

<font color="#FF7F00"></font>

渲染示例：橙色文字

2.蓝色文字：

<font color="#7093DB"></font>

渲染示例：蓝色文字

3.四号字：

<font size="4"></font>

渲染效果：

四号字

五、微调字号

这个很少有人在Markdown教程里讲到，需要的时候用一下也不错。

借助HTML标签big/small，即可微调文字大小。

语法示例：

<big>大号文字</big><small>小号文字</small>

渲染效果：

大号文字

小号文字

六、删除线

用俩 ~ 左右包起来即可，也可以用HTML的 <s> </s> 标签来实现（不推荐）。

语法示例：

~~Markdown 删除线内容~~<s>HTML 删除线内容</s>

渲染效果：

~~Markdown 删除线内容~~

~~HTML 删除线内容~~

七、下划线

Markdown本身并不提供下划线标签，需要借助HTML的   标签。

语法示例：

<u>下划线文字</u>

渲染效果：

下划线文字

八、无序列表

无序列表是一个项目的列表，此列项目使用粗体圆点进行标记。

Markdown无序列表写法非常简单，减号（或加号、星号）加一个空格即可。

注：推荐使用减号，因为星号常用于斜粗体。

语法示例：

- Markdown无序列表+ Markdown无序列表* Markdown无序列表

渲染效果：

Markdown无序列表

Markdown无序列表

Markdown无序列表

当然啦，还可以用html的 <ul> </ul> 和 <li> </li> 标签来实现（极其复杂，不推荐）。

HTML语法示例：

<ul>    <li>Coffee</li>    <li>Milk</li></ul>

渲染效果：

Coffee
Milk

九、有序列表

和无序列表类似，有序列表也是一列项目，列表项目使用数字进行标记。

注：相较于其他文字，列表部分会轻微向右偏移。

Markdown有序列表写法非常简单，数字加小数点，然后加一个空格即可。

语法示例：

1. Markdown有序列表2. Markdown有序列表

渲染效果：

Markdown有序列表
Markdown有序列表

当然啦，还可以用html的 <ol> </ol> 和 <li> </li> 标签来实现（极其复杂，不推荐）。

HTML语法示例：

<ol>    <li>Coffee</li>    <li>Milk</li></ol>

渲染效果：

Coffee
Milk

十、嵌套无序列表

无序列表是可以多层嵌套的，在子层列表的行首放两个或更多个空格即可。

语法示例：

- 嵌套列表  - 二级列表    - 三级列表

渲染效果：

嵌套列表
- 二级列表
  - 三级列表

来个复杂点的？

语法示例：

- 儒- 释- 道    - 书籍        - 道德经    - 著名人物        - 张道陵        - 葛玄        - 萨守坚        - 许旌阳

渲染效果：

儒
释
道
- 书籍
  - 道德经
- 著名人物
  - 张道陵
  - 葛玄
  - 萨守坚
  - 许旌阳

当然啦，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>

渲染效果：

儒
释
道
- 书籍
  - 道德经
- 著名人物
  - 张道陵
  - 葛玄
  - 萨守坚
  - 许旌阳

十一、引用

Markdown中通过 > （大于号）加一个空格实现 引用 。

语法示例：

> 从你的全世界路过

渲染效果：

从你的全世界路过

进阶玩法

引用 也可以多级嵌套（连续使用多个 >，加一个空格），而且支持和其它Markdown标签搭配使用，比如无序列表。

语法示例：

> 一级引用文本>> 二级引用文本>> - 二级引用，无序列表>>> 三级引用文本>>> * 三级引用，无序列表

渲染效果：

一级引用文本

二级引用文本

二级引用，无序列表

三级引用文本

三级引用，无序列表

十二、代码

并不一定真要放代码时才能用这个标签，这里举两个例子：

1.如果要重点突出某个字，可以用行内代码标签

2.如果不想让Markdown渲染某段文字，可以用代码块标签进行包裹

Markdown中代码格式化可以通过三种方式：

行内式：通过一对 ` 包裹单行代码/文字实现；

代码块：通过一对 ``` 包裹实现，可以指定代码的编程语言，如Python、JavaScript、Rust等，如果渲染器支持，将实现语法高亮；

缩进式：通过缩进至少四个空格实现，部分支持语法高亮。

前两个很常用，缩进式写起来很恶心，不推荐。

代码块支持高亮显示，支持标注以下语言：

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.代码块（无需缩进）：\``` pythonimport os, syssys.pathprint(os)\```3.缩进式：    if (isAwesome){      return true    }

注：为避免标签渲染冲突，代码块标签前面我加了个反斜杠。

渲染效果：

1.行内式代码： import os, sys

2.代码块（无需缩进）：

import os, syssys.pathprint(os)

3.缩进式：

if (isAwesome){  return true}

十三、注释

被注释的文字不会显示出来。

推荐写法：

[](注释内容，渲染时不会显示)

后边的不用看了，使用率很低很低。

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解析原理自由组合语法）。

十四、任务清单

固定写法，没必要去记。

语法示例：

- [ ] 未完成- [x] 已完成

渲染效果：

[ ] 未完成
[x] 已完成

十五、变量

Markdown 中支持变量定义和变量引用，且支持中文。

一处定义，处处使用，而且方便统一修改。

变量定义：[key]:value
变量引用：[key]、[text][key]

语法示例：

步骤1.定义链接[KK博客]:https://kk.hackerjk.top步骤2.引用链接：(1) key引用方式：[KK博客](2) value引用方式：[自定义文本][KK博客]

渲染效果：

步骤1.定义链接

步骤2.引用链接：

(1) key引用方式：KK博客

(2) value引用方式：自定义文本

食用方法：

可将定义变量的文字扔到文章底部，在需使用该变量的位置，插入调用标签（第一个中括号里填写要显示的文字）。

十六、图片

格式：![Alt Text](img url)

语法示例：

![图片文字描述](https://static-upyun.ricken.cn/Web/icons/Blog/2233.png)

渲染效果：

图片文字描述

也支持HTML图片标签，顺便贴一下吧。

HTML语法示例：

<img src = 'https://static-upyun.ricken.cn/Web/icons/Blog/2233.png' />

渲染效果：

十七、链接

有些Markdown工具不支持自动识别http开头的url链接，用<>包裹链接即可，如：

<https://kk.hackerjk.top>

渲染效果：

https://kk.hackerjk.top

若需指定url链接文本，格式：[文本](url)

语法示例：

[kk](https://kk.hackerjk.top)

渲染效果：

十八、锚点

在纯Markdown环境下一般（自信点，去掉这俩字）是无法生效的，需要在网页内展示。如使用Typora导出为.html文件，或使用CSDN等博客平台。

语法示例：

<a href="#标记">锚点标题</a><a id="标记">跳转到此处</a>

渲染效果：

锚点标题

跳转到此处

没思路在不依赖网页时实现该功能，如果确实有需要，建议用Typora导出成html文件。

十九、表格

语法示例：

| 左对齐 | 居中对齐 | 右对齐 || :-----| :----: | ----: || 单元格 | 单元格 | 单元格 || 单元格 | 单元格 | 单元格 || 单元格 | 单元格 | 单元格 || 单元格 | 单元格 | 单元格 |

渲染效果：

左对齐	居中对齐	右对齐
单元格	单元格	单元格
单元格	单元格	单元格
单元格	单元格	单元格
单元格	单元格	单元格

不是很建议大家使用表格，编辑过程很繁琐。

二十、特殊字符

语法示例：

空格符：&nbsp;小于号：&lt;大于号：&gt;和号：&amp;人民币：&yen;版权：&copy;注册商标：&reg;摄氏度：&deg;正负号：&plusmn;乘号：&times;除号：&divide;平方（上标²）：&sup2;立方（上标³）：&sup3;

渲染效果：

注：在空格符的上下方各插入一个空行，即可在渲染时显示空白行。

二十一、对齐文字

Markdown并不提供“居中”等语法标记，需要借助HTML标签来实现。

语法示例：

center标签：<center>居中文字</center>align标签：<p align=center>居中文字</p>align标签：<p align=right>右对齐文字</p>

渲染效果：

center标签：

居中文字

align标签：

居中文字

align标签：

右对齐文字

二十二、媒体文件

播放视频代码：

<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>

由于 ChaTi/轻记使用TextView（文本框）进行渲染，难以插入视频、音频这种媒体文件，所以请考虑用跳到链接的方式单独播放。

示例：

MP3音频-追光者

当然，可能会直接调用下载器来下载该文件。即便能在WebView（浏览器组件）内直接播放音频，安卓原生界面也着实“一言难尽”。

二十三、联系方式

QQ聊天

Markdown和HTML的链接标签均可，uin即为QQ号。

[QQ联系](http://wpa.qq.com/msgrd?v=3&uin=1942113505&site=qq&menu=yes)<a target="_blank" href="http://wpa.qq.com/msgrd?v=3&uin=1942113505&site=qq&menu=yes">QQ联系</a>

渲染效果：

QQ联系

邮件反馈

因为 ChaTi/轻记自定义了链接协议和解析流程，所以此处只使用HTML标签，避免参数丢失。

<a target="_blank" href="mailto:1942113505@gmail.com?subject=KK">发送邮件</a>

mailto参数为收件邮箱，subject参数为邮件主题，a标签参数即为要显示的文本。

渲染效果：

发送邮件

一、标题

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

二、段落

三、斜/粗 体

四、字号/颜色

五、微调字号

六、删除线

七、下划线

八、无序列表

九、有序列表

十、嵌套无序列表

十一、引用

进阶玩法

十二、代码

十三、注释

十四、任务清单

十五、变量

十六、图片

十七、链接

十八、锚点

十九、表格

二十、特殊字符

二十一、对齐文字

二十二、媒体文件

二十三、联系方式

QQ聊天

邮件反馈

发表评论 取消回复

markdown全教程

一、标题

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

二、段落

三、斜/粗 体

四、字号/颜色

五、微调字号

六、删除线

七、下划线

八、无序列表

九、有序列表

十、嵌套无序列表

十一、引用

进阶玩法

十二、代码

十三、注释

十四、任务清单

十五、变量

十六、图片

十七、链接

十八、锚点

十九、表格

二十、特殊字符

二十一、对齐文字

二十二、媒体文件

二十三、联系方式

QQ聊天

邮件反馈

三、斜/粗体

发表评论取消回复

三、斜/粗体