一、标题

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.橙色文字:

<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> 标签。

语法示例:

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

渲染效果:

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

十一、引用

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.hackricken.top/Web/icons/Blog/2233.png)

渲染效果:

图片文字描述


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

HTML语法示例:

<img src = 'https://static.hackricken.top/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标签参数即为要显示的文本。

渲染效果:

发送邮件

END
本文作者:
文章标题:markdown全教程
本文地址:https://kk.hackerjk.top/study/markdown.html
版权说明:若无注明,本文皆由小陈的小角落原创,转载请保留文章出处。
最后修改:2022 年 05 月 19 日 05 : 45 PM
要不?请我吃一下沙县连锁大酒店?