Markdown语法

  |     |   本文阅读:

基本语法

书写Markdown时可以嵌套html语法来实现一些原生Markdown不支持的效果

定义一个标题

一个#为一级标题,两个##为二级标题,以此类推,Markdown最多支持6级标题。

  • 可以复制以下代码试验
    # 这是一级标题
    ## 这是二级标题
    ### 这是三级标题
    #### 是四级标题
    ##### 这是五级标题
    ###### 这是六级标题
    
  • 扩展语法,在文字下面加上两个以上的=-
一级标题
=======
二级标题
-------

字符样式

  1. 斜体
    *斜体*_斜体_都能实现斜体效果
  2. 粗体
    **粗体**__粗体__都能实现粗体效果
  3. 删除线
    ~~删除线~~
  4. 组合体
    ~~***组合体***~~

注音

此为vscode添加的插件Markdown Paste的功能
选中要标注的文字按快捷键Ctrl+Alt+T即可开始注音

聪明(pronunciation)

<ruby>聪明<rp>(</rp><rt>pronunciation</rt><rp>)</rp></ruby>

插件地址

列表

无序列表

  • Item1
  • Item2
    • Item1
    • Item2
      • Item1
  • Item3

无序列表中可以用字符*+-来做标记,一个制表符或4个空格来确定列表间的母子关系。

* Item1
* Item2
    * Item1
    * Item2
        * Item1
* Item3

有序列表

  1. Item1
  2. Item2
  3. Item3

有序列表和无序列表不同之处在于有序列表会按第一位的数值进行自动的编号排序。

2. Item1
1. Item2
10. Item3

任务列表

  • 写markdown语法笔记
  • 睡觉
- [x] 写markdown语法笔记
- [ ] 睡觉

添加链接

123@qq.com
https://i.loli.net/2018/09/16/5b9dbce0bac35.png
<https://i.loli.net/2018/09/16/5b9dbce0bac35.png>
<123@qq.com>
<https://i.loli.net/2018/09/16/5b9dbce0bac35.png>
  • 超链接

    • 不带鼠标悬停Title链接
      测试链接1
        [测试链接1](https://i.loli.net/2018/09/16/5b9dbce0bac35.png)
      
    • 带鼠标悬停Title链接

      邮箱链接暂时没找到方法带Title

      测试链接

        [测试链接](https://i.loli.net/2018/09/16/5b9dbce0bac35.png "测试链接")
      

添加图片

测试

  • 添加本地图片

    同级目录开始索引,部署到GitHub后会变成从根目录开始索引,因此务必要用一个专门的文件夹来储存图片

![测试](测试.png)
  • 添加网络图片
    ![测试](https://i.loli.net/2018/09/16/5b9dbce0bac35.png)
    
  • 可复用的图片链接
    测试图片
![测试链接][1]**//注意最少要有一个空行的间隙**

[1]:https://i.loli.net/2018/09/16/5b9dbce0bac35.png "测试链接"
  • 分享音频

    部分主题支持调用的网页内嵌播放器不一样



  • 分享视频

    同音频一样部分主题支持的播放器不一样,有些网站可以有些不行。可以在网站的分享界面获得外链的内嵌代码。



引用

下面嵌套一个代码

 Console.WriteLine("TestCode");
 Console.WriteLine("TestCode");
 Console.WriteLine("TestCode");
>下面嵌套一个**代码**
> ```c#{.line-numbers}
 Console.WriteLine("TestCode");
 Console.WriteLine("TestCode");
 Console.WriteLine("TestCode");

分割线

两个以上*或者_


****

行内代码

这是一整行句子,我要在这里插入代码code

这是一整行句子,我要在这里插入代码`code`

代码块

Console.WriteLine("TestCode");
Console.WriteLine("TestCode");
Console.WriteLine("TestCode");
  • c#{.line-numbers} 代表指定语言和显示代码行数

    以下显示的效果为不加{.line-numbers}的样子
    部分主题默认显示代码行数

    Console.WriteLine("TestCode");
    Console.WriteLine("TestCode");
    Console.WriteLine("TestCode");

表格

--的左或者右打上:可以决定对齐方式。两边都打为居中

第一列 第二列 第三列
1 2 3
3 1

原生Markdown语法不支持表格合并等高级操作,需要添加插件实现

 第一列 | 第二列|第三列 
 --:|:--|:--:
 1 | 2|3
 3 | 1| |

以上语法已支持绝大多数创作所需,以下语法可以根据所用的编辑器支持和自身情况进行适当的扩展


数学公式

根据主题渲染方式有不同的语法支持,比较常用的有KaTexMathJax两种

下面应该会写MathJax的语法

TODO..

图表

TODO..
参考链接

目录列表(TOC)

某些主题会有自己相应的TOC生成方式,详情看自己应用的主题说明

一般情况下在想要插入目录的位置写上[TOC]就可以实现目录的插入

扩展语法

现在使用的hexo主题Yelee并不支持以下语法效果(2018.9.19)

上标

我要一个上标^给你^,谢谢
12^th^

我要一个上标<b>^给你^</b>,谢谢
12^th^

下标

H~2~O~2~

H<b>~2~</b>O~2~

注脚

我需要一个注脚[^5]
[^5]:这是一个注脚

注脚在编辑时可以写在任意位置

我需要一个注脚[^5]
[^5]:这是一个注脚

文本说明

[HTML]:Hyper Text Markup Language
The HTML specification
我 不明白。
[不明白]:你必须明白

鼠标悬停时可以看到对一个关键词的解释说明
说明文本可以在任意地方

*[HTML]:Hyper Text Markup Language
The HTML specification
我 不明白。**//注意空格**
*[不明白]:你必须明白

高亮文本

==我需要发光==

==我需要发光==

文章摘要

文章摘要

GitHub 仓库展示小挂件

GitHub 仓库展示小挂件

参考资料

  1. https://daringfireball.net/projects/markdown/
  2. https://www.jianshu.com/p/8c1b2b39deb0
  3. https://blog.csdn.net/wybluewind/article/details/47752597
  4. https://segmentfault.com/markdown#articleHeader2
  5. https://blog.csdn.net/witnessai1/article/details/52551362
  6. https://guides.github.com/features/mastering-markdown/
  7. https://shd101wyy.github.io/markdown-preview-enhanced/#/zh-cn/markdown-basics
  8. http://moxfive.xyz/2015/08/30/EndNote-Markdown/
文章目录
  1. 1. 基本语法
    1. 1.1. 定义一个标题
    2. 1.2. 字符样式
    3. 1.3. 注音
    4. 1.4. 列表
      1. 1.4.1. 无序列表
      2. 1.4.2. 有序列表
      3. 1.4.3. 任务列表
    5. 1.5. 添加链接
    6. 1.6. 添加图片
    7. 1.7. 引用
    8. 1.8. 分割线
    9. 1.9. 行内代码
    10. 1.10. 代码块
    11. 1.11. 表格
  2. 2. 数学公式
  3. 3. 图表
  4. 4. 目录列表(TOC)
  5. 5. 扩展语法
    1. 5.1. 上标
    2. 5.2. 下标
    3. 5.3. 注脚
    4. 5.4. 文本说明
    5. 5.5. 高亮文本
    6. 5.6. 文章摘要
    7. 5.7. GitHub 仓库展示小挂件
  6. 6. 参考资料
本站到访 | |