手把手教你Markdown语法

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只取出了整数部分。

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

  1. 橙色文字:

渲染示例:橙色文字

  1. 蓝色文字:

渲染示例:蓝色文字

  1. 四号字:

渲染效果:

四号字


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

渲染效果:

  • Markdown无序列表
  • Markdown无序列表
  • Markdown无序列表

当然啦,还可以用html的

  • 标签来实现(极其复杂,不推荐)。

    HTML语法示例:

    <ul>
        <li>Coffeeli>
        <li>Milkli>
    ul>
    

    渲染效果:

    • Coffee
    • Milk

    9、Markdown 有序列表

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

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

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

    语法示例:

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

    渲染效果:

    1. Markdown有序列表

    2. Markdown有序列表

      当然啦,还可以用html的

    3. 标签来实现(极其复杂,不推荐)。

    HTML语法示例:

    <ol>
        <li>Coffeeli>
        <li>Milkli>
    ol>
    

    渲染效果:

    1. Coffee
    2. Milk

    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 联系方式

    QQ聊天

    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标签参数即为要显示的文本。

    渲染效果:

    发送邮件

    你可能感兴趣的:(Markdown,Markdown语法)