一、标题

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

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

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

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

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

语法示例：

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

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

渲染效果：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

二、段落

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

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

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

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

渲染效果1：

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

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

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

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

渲染效果2：

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

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

三、斜/粗 体

文字倾斜：

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

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

文字加粗：

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

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

斜粗体文字：

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

示例文本：

*斜体文本*

_斜体文本_

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

**粗体文本**

__粗体文本__

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

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

***粗斜体文本***

___粗斜体文本___

渲染效果：

斜体文本

斜体文本

HTML斜体文本

粗体文本

粗体文本

HTML加粗内容示例

HTML加粗文字

粗斜体文本

粗斜体文本

四、字号/颜色

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

正常情况下，字号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.橙色文字：
[](005i)

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

[]( 005i)
渲染示例：橙色文字

2.蓝色文字：
[](006i)

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

[]( 006i)
渲染示例：蓝色文字

3.四号字：
[](008i)

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

[]( 008i)
渲染效果：

四号字

五、微调字号

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

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

语法示例：

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

渲染效果：

大号文字

小号文字

六、删除线

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

语法示例：

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

渲染效果：

Markdown 删除线内容

HTML 删除线内容

七、下划线

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

语法示例：

<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有序列表

渲染效果：

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

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

HTML语法示例：

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

渲染效果：

  1. Coffee
  2. 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>

渲染效果：

  • 儒
  • 释
  • 道
    • 书籍
      • 道德经
              </li>
        <li>著名人物
            <ul>
                <li>张道陵</li>
                <li>葛玄</li>
                <li>萨守坚</li>
                <li>许旌阳</li>
            </ul>
        </li>
    </ul>
</li>

    十一、引用

    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

    语法示例：

    步骤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)

    渲染效果：

    kk

    十八、锚点

    在纯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联系

    QQ联系

    邮件反馈

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

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

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

    渲染效果：

    发送邮件

最后修改：2022 年 05 月 19 日
© 允许规范转载
要不？请我吃一下沙县连锁大酒店？