• Markdown格式及语法


    什么是Markdown

    Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
    Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。
    Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
    Markdown 编写的文档后缀为 .md/.markdown

    Markdown编写标题

    方法一(编写一级二级标题)

    在Markdown语法中,我们可以使用"="来表示一级标题,用"-"来表示二级标题,例如:

       我是一级标题
       ===========
       我是二级标题
       -----------
    
    方法二(适用1——6级标题)

    我们也可以使用#来声明标题,#代表一级标题,##代表二级标题,以此类推,例如:

    #我是一级标题
    ##我是二级标题
    ###我是三级标题
    ####我是四级标题
    ....
    ######我是六级标题

    Markdown段落

    Markdown并没有特殊的段落格式,可以像普通文本一样进行编辑,换行可以使用2个及以上空格+回车或直接空出一行实现。

    字体

    Markdown支持字体的设置,我们可以通过一下手段实现一些改动。

    *斜体文本*
    _斜体文本_
    **粗体文本**
    __粗体文本__Markdown中
    ***粗斜体文本***
    ___粗斜体文本___

    特殊格式

    分割线:
    我们可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格,例如:

    ***
    * * *
    ---
    - - -
    ----------
    效果:

    下划线:
    很遗憾,要想在Markdown中实现下划线的样式,我们需要使用HTML中的<u>标签来实现。

    删除线:
    在Markdown中,我们仅需在要添加删除线样式的范围前后各使用使用两个~将其包裹便可。例如:

    ~~我是要删除的范围~~
    我是要删除的范围

    注脚:
    Markdown的角标声明格式为 [^注脚]:文字。

    Markdown列表

    在Markdown中,支持无序列表和有序列表,无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记,这些标记后面要添加一个空格,然后再填写内容,例如:

    * 第一
    + 第一
    - 第一
    效果如下:

    • 第一
    • 第一
    • 第一

    有序列表则使用数字并加上 . 号来表示,例如:

    1. 第一
    2. 第二
    3. 第三
      效果如下:
    1. 第一
    2. 第二
    3. 第三
      注意:Markdown列表支持嵌套,嵌套时只需在子列表中的选项前面添加四个空格即可。

    Markdown区块

    Markdown写法为:>文本,例如:
    >文本
    效果如下:

    文本
    注意:Markdown区块亦支持嵌套,且可与列表等其他段落格式互相嵌套,列表亦如此。

    Markdown代码

    在Markdown中添加代码块有多种方法。

    方法一:

    一个函数或片段的代码可以用反引号把它包起来(`),例如:

    `printf()` xx

    效果如下:
    printf() xx

    方法二:

    使用 4 个空格或者一个Tab,例如:

      int main() {
          ios::sync_with_stdio(false);
          return 0;
      }
    
    方法三:

    用 ``` 包裹一段代码,并指定一种语言(也可以不指定),例如:

    ``` C++
    int main() {
    ios::sync_with_stdio(false);
    return 0;
    }
    ```

    效果如下:

    int main() {
    	ios::sync_with_stdio(false);
    	return 0;
    }
    

    Markdown链接

    在Markdown中,可以通过如下方式建立链接:

    [链接名称](链接地址)或<链接地址>

    亦可使用高级链接方式,即通过变量来设置一个链接,变量赋值在文档末尾,例如:

    这个链接用 1 作为网址变量 [Google][1]
    这个链接用 xxx 作为网址变量 [Baidu][xxx]
    然后在文档的结尾为变量赋值(网址)

    [1]: http://www.google.com/
    [xxx]: http://www.Baidu.com/

    效果如下:

    这个链接用 1 作为网址变量 Google
    这个链接用 xxx 作为网址变量 Baidu
    然后在文档的结尾为变量赋值(网址)

    Markdown图片

    Markdown亦支持插入图片,具体语法如下:

    ![alt 属性文本](图片地址)

    ![alt 属性文本](图片地址 "可选标题")

    Markdown表格

    使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
    语法如下:

    | 表头 | 表头 |
    | ---- | ---- |
    | 单元格 | 单元格 |
    效果如下:
    | 表头 | 表头 |
    | ---- | ---- |
    | 单元格 | 单元格 |
    | 单元格 | 单元格 |
    值得一提的是,Markdown可以设置表格的对齐方式,语法示范如下:
    -: 设置内容和标题栏居右对齐。
    :- 设置内容和标题栏居左对齐。
    :-: 设置内容和标题栏居中对齐。
    可以自行进行尝试。

    Markdown高级技巧

    数学公式

    Markdown可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染,例如:

    [mathbf{V}_1 imes mathbf{V}_2 = egin{vmatrix} mathbf{i} & mathbf{j} & mathbf{k} \ frac{partial X}{partial u} & frac{partial Y}{partial u} & 0 \ frac{partial X}{partial v} & frac{partial Y}{partial v} & 0 \ end{vmatrix} ${$tep1}{style{visibility:hidden}{(x+1)(x+1)}} ]

    其源码如下:

    $$
    mathbf{V}_1 	imes mathbf{V}_2 =  egin{vmatrix} 
    mathbf{i} & mathbf{j} & mathbf{k} \
    frac{partial X}{partial u} &  frac{partial Y}{partial u} & 0 \
    frac{partial X}{partial v} &  frac{partial Y}{partial v} & 0 \
    end{vmatrix}
    ${$tep1}{style{visibility:hidden}{(x+1)(x+1)}}
    $$
    
    其他技巧

    因为Markdown支持HTML文本,除数学公式略有不同外,可以借由HTML来实现所有样式。

    参考:
    菜鸟教程

  • 相关阅读:
    企业视频会议EasyRTC视频云服务是如何满足不同企业多场景直播的?
    TSINGSEE青犀视频H265网页播放器EasyPlayerPro-Win如何通过配置文件实现自动播放等功能?
    TSINGSEE青犀视频自主研发H265播放器EasyPlayerPro-Win C++如何获取软件版本信息源码
    RTMP视频直播点播平台EasyDSS及企业视频通话会议系统EasyRTC内启动nginx 配置重定向功能介绍
    面向对象程序设计上机练习二(函数模板)
    2014暑假ACM训练总结
    codeforces 之 Little Pigs and Wolves
    SDUT 2766 小明传奇2
    0-1背包的总结
    POJ 2063 Investment (完全背包)
  • 原文地址:https://www.cnblogs.com/RpgMaker/p/13550954.html
Copyright © 2020-2023  润新知