写在前面

最近一段时间学习的同时也在做一些笔记,想着将笔记发布出来加深印象并能够方便查找,看了一些大佬的文章后,不得不感慨大佬们编写文章的整洁度和可读性,因此经过仔细斟酌后,只有Markdown才是用来写文章的NO1;

为了能够潇洒的掌握Markdown,可以做到像写母语一般的程度,特意花时间使用Markdown语法来编写Markdown语法的使用说明;
以下内容使用vscode编写的文档,各编辑器的用法基本相同,可以自行选择


Markdown介绍

Markdown是一种纯文本格式的标记语言,通过简单的标记语法,使普通文本具有一定格式;
Markdown目标实现【易读易写】;成为适用于网络的书写语言;


Markdown兼容HTML

Markdown并非取代HTML,他的语法很少,只对应 HTML 标记的一小部分。
Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来,HTML 已经很容易写了。Markdown 的理念是,能让文档更容易读、写和随意改。HTML 是一种发布的格式,Markdown 是一种书写的格式。就这样,Markdown 的格式语法只涵盖纯文本可以涵盖的范围。
在md文档中,可直接使用HTML语法,不需要额外标注HTML还是Markdown语法;
html的块级元素,div、p等;必须在前后加上空行与其他内容隔开
摘自W3Cschool
https://www.w3cschool.cn/Markdownyfsm/cfl1dz.html

如下:可直接编写html
注意

在 HTML 区块标签间的 Markdown 格式语法将不会被处理。比如,你在 HTML 区块内使用 Markdown 样式的*强调*会没有效果。
注意

span、a、img这样的行内元素可以在md文档中随意使用,按照个人习惯,甚至可以不用Markdown语言,如果比较喜欢 HTML 的 a或img标签,可以直接使用这些标签,而不用 Markdown 提供的链接或是图像标签语法

Markdown常用html标签例子

所有html标签都非常Nice,这里我只标出自己最得意的

1、<kbd>标签

kbd标签在日常笔记中,用来标注按钮类文字,效果杠杠的;

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

效果:使用 Ctrl+Alt+Del 重启电脑

2、©:
如果要显示©符号,那么就写成&copy;

3、换行<br/>:
在文档中,使用Markdown的区块引用,可以使段落更加美观,但在有一些特殊需要的地方,仍然需要换行,这时候使用html的br换行标签最好不过;


标题

Markdown支持两种标题的语法:
第一种是用=和-分别标记一级标题和二级标题,语法格式:

这是一个一级标题
==============

这是一个二级标题
--------------

任何数量的=和-都有效果。
显示效果如下:

第二种是使用#来标记,在每行开始插入1~6个#,
分别表示1~6级标签
语法格式:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

显示效果如下:


列表

Markdown支持有序列表和无序列表;

无序列表

使用*、+、-三个符合表示无序列表,三个符号含义相同用哪个都行。同一级别的列表项建议使用同一个符号,避免眼花缭乱;
无序列表无论使用那种符号,如果需要实现多级列表,只需要在选项前面加上四个空格或者制表符
写法如下:

* 第一项
     * 第一项的子项
          * 第一项子项的子项
* 第二项
    * 第二项的子项
* 第三项

显示效果:

有序列表

有序列表的语法格式为:s数字+英文的点’.’+空格+内容
并且数字的大小不需要担心,列表序号根据第一个数字依次排列,所以除了第一项,其他项只需要随便写个数字就行,但是为了自己的维护和易读性,建议按照正常操作编写。

语法格式:

1. aaaaaaaa
2. bbbbbbbb
3. cccccccc
4. dddddddd
8. eeeeeeee
323. gggggggg

显示效果:

列表嵌套

有序列表和无序列表可以根据需要随意交叉嵌套,只需要在每项前面加制表符或四个空格即可;
语法格式:

+ 无序列表第一项
    1. 有序列表1-1
          + 无序列表1-1-1
          + 无序列表1-1-2
+ 无序列表第二项
    + 无序列表2-1
    + 无序列表2-2
+ 无序列表第三项
    1. 有序列表3-1
    2. 有序列表3-1
    3. 有序列表3-3

显示效果:


区块引用

区块引用是在段落开头使用>符号,后面跟一个空格,然后书写内容就会放在区块显示。
可以在每行前面都加上>符号,也可以只在第一行加上>符号。
(个人建议每行前面都加上,提高规范性)

基本格式

语法格式:

> 区块内内容
> 区块内容文字说明

显示效果:

嵌套列表

>- aaaaaaa
>- bbbbbb
>1. 第一项
>2. 第二项
>3. 第三项

显示效果:

嵌套其他Markdown语法

>其他Markdown语法在区块内都适用。
>比如:
>分割线:
>-------
>标题:
>### 标题

显示效果:

多级区块嵌套

同样区块也可以嵌套使用,根据 > 的数量决定嵌套级别。

语法格式:

> 一层
 >> 二层
 >>> 三层
 >>>> 四层
 >>>>> 五层
 >>>>>> 六层
 >>>>>>> 七层
 >>>>>>>> 八层

显示效果:

与无序列表配合使用

无序列表与区块可以互相嵌套,巧妙地使用可以展现出不错的样式。

例如:

+ 我们坐着喝着啤酒,阳光洒在肩头,觉得是个自由人
          > 肖申克的救赎
+ 人生就像一盒巧克力,你永远不会知道下一块将会是哪种
          > 阿甘正传

显示效果

例如:

>电影名句
>   + 我们坐着喝着啤酒,阳光洒在肩头,觉得是个自由人
>            > 肖申克的救赎
>   + 人生就像一盒巧克力,你永远不会知道下一块将会是哪种
>            > 阿甘正传

显示效果:


分割线

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

- - -
* * *
_ _ _
显示效果:




代码

代码区块

在Markdown中建立代码区块只需要在代码每行前面加1个制表符4个空格即可,Markdown会自动显示成代码区块。
例如:

普通的文本前面没有制表符和空格;

  下面都是在行首加上制表符的代码行:

  这是一个代码区块。
  <div class=“footer”>
    &copy; 2004 Foo Corporation
  </div>
  //代码注释,伊人夕岸

显示效果:

普通的文本前面没有制表符和空格;

下面都是在行首加上制表符的代码行:<div class="footer">&copy; 2004 Foo Corporation
</div>
//代码注释,伊人夕岸

行内代码

要显示一行代码,或者在一行文字中加一小行代码,可以用反引号 ` 吧代码包起来.

语法格式:

我的代码:`int[] a = new int[5] { 1,2,3,4,5}; `

显示效果:
我的代码:int[] a = new int[5] { 1,2,3,4,5};

代码区块2

可以在一段代码的前后加上 ``` 包裹住代码块,并且可以指定语言;

语法格式:

```CSharp
int[] a = new int[5] { 1,2,3,4,5};
int[] b = new int[a.Length];
Array.Copy(a,0,b,0,2);
foreach (int c in b) {
Console.WriteLine©;
}
```

显示效果:

 int[] a = new int[5] { 1,2,3,4,5}; int[] b = new int[a.Length];Array.Copy(a,0,b,0,2); foreach (int c in b) {Console.WriteLine(c); }

链接

在方括号后面加上圆括号,方括号写链接名字,圆括号写链接地址,在圆括号里面的链接后面,用双引号可以编写title文字(连接和title文字中间需要空格)
语法格式:

[链接](Http://www.xxxxx.com “第三方链接”)

显示效果:
链接

也可以直接用尖括号将链接括起来,(在VScode中直接复制一个链接也会被编译成链接不需要加尖括号,属于VS的编译功能,在发布的时候切记不要忘记,因为有些平台无法识别。

图片

图片的语法格式与链接基本相同,只需要在最前面加上一个 ! 号,后面中括号放上图片的替代文字,在跟一个圆括号里面放上图片的地址,并且也可以像链接一样,在图片路径后面加上title显示文字。

语法格式:

![我的图片](/InfoMD/Images/AtxTitle.png “我的图片”)

显示效果

在这里先不展示图片了,因为实在找不出合适的图片,老铁们可自行测试^_^

Markdown无法设置图片的宽高格式,如果需要可以使用HTML的 img 标签。

表格

Markdown使用管道符 | 来分割不同的单元格,使用 - 来分割表头和其他行
语法格式

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

显示效果:

表头 表头
单元格 单元格
单元格 单元格
设置表格单元格格式

:- 左对齐
:-: 居中
-: 右对齐

语法格式:

|左对齐|居中|右对齐|
|:---|:---:|---:|
|单元格|单元格|单元格|

显示效果:

左对齐 居中 右对齐
单元格 单元格 单元格
                                                        

其他格式语法

转译

在Markdown中的特殊语法符号,如果在使用中只想显示他们本来的样子,不想显示转译后的样子,这首只需要在符号前面加上反斜杠即可。
例如:

\[链接](WWW.xxx.com)

这样就能显示成本来样子,不会编译成链接。

字体

Markdown支持以下字体格式:

斜体粗体

在文字两端加上不同数量的 * 或 _ 符号

语法格式:

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

显示效果:

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本

写在最后

以上都是作者在学习过程中总结的内容,不代表全部Markdown语法文档,在某些语法中也可能不是唯一的实现方法。欢迎老铁们对文档中的内容问题进行交流

个人交流QQ:1695690324
原创不易,转载请注明出处

Markdown语法文档,Markdown教程,Markdown语法大全,相关推荐

  1. H264参数语法文档: SPS、PPS、IDR

    From: http://blog.csdn.net/heanyu/article/details/6205390 H.264码流第一个 NALU 是 SPS(序列参数集Sequence Parame ...

  2. Smali 语法文档

    可以选择保存成pdf格式,查询起来挺方便的 if v0==0 go cond_0 if-eqz v0, :cond_0 if v0!=0 go cond_0 if-nez v0, :cond_0 v1 ...

  3. 菜鸟教程 MarkDown语法

    菜鸟教程之MarkDown语法 MarkDown标题 MarkDown段落 MarkDown字体 MarkDown分隔线 MarkDown删除线 MarkDown脚注 MarkDown列表 MarkD ...

  4. 标准md语法教程- Markdown从入门到精通(上)

    写在前面: 目的:这个文档自身就是使用 Markdown 编写的.Markdown 允许你通过编写易读.易写的富文本格式,然后很方便就可以转换成有效的 HTML. 本教程以一般方案的书写习惯为便.致力 ...

  5. Markdown教程--Markdown图片

    Markdown教程–Markdown图片 Markdown 图片语法格式如下: ![alt 属性文本](图片地址)![alt 属性文本](图片地址 "可选标题") 开头一个感叹号 ...

  6. Markdown语法大全(超级版)

    Markdown语法大全(超级版) CSDN的参考文档并不全-- 文章目录 Markdown语法大全(超级版) 概述 设计理念 内联 HTML 语法 特殊字符自动转义 行内语法讲解 注释的表述 代码法 ...

  7. markdown 中文文档

    Markdown: 语法 概述 设计理念 内联 HTML 特殊字符自动转义 块级元素 段落和换行 标题 块引用 列表 代码块 水平线 内联元素 链接 强调 代码 图片 其他 反斜杠转义 自动链接 说明 ...

  8. Markdown编辑器语法大全

    一.什么是Markdown? Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber).它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者H ...

  9. Markdown官方文档[翻译]

    概述 哲学 Markdown目标是实现"易读易写". Markdown最大的亮点在于它的可读性.一篇Markdown格式的文档可以直接以纯文档的形式发布,并且它看起来并不会由标签和 ...

最新文章

  1. Maven 私服搭建指南
  2. C++编程易范的错误
  3. 5.25. Spring boot with Git version
  4. Git 学习笔记--3.EGit使用手册
  5. 请求时的编码问题 Use body.encode(‘utf-8‘) if you want to send it encoded in UTF-8
  6. MySQL Percona PXC集群实现MySQL主从复制强一致性
  7. Android 中的线程及 AsyncTask(线程形态之一)解析一下
  8. 选择排序法python详解-Python选择排序算法(三)
  9. Web Js 按键事件……Enter提交事件 Enter Js事件
  10. ubuntu jdk tomcat mysql_Ubuntu下安装JDK+TOMCAT+MYSQL
  11. minishell的实现及IO接口的调用
  12. 正确获取CleanMyMac注册码并激活
  13. 【团队技术知识分享 一】技术分享规范指南
  14. 大数据智能学院的硕士论文怎么写_大数据智能营销笔记本怎么样
  15. Git初学(5)--关联远程库
  16. 自然常数e的矩阵指数
  17. while(true) Thread.Sleep(XX)我通常是用这种写法,有没有更好的写法或者改进
  18. 如约而至:微信自用的移动端IM网络层跨平台组件库Mars已正式开源
  19. WeChat----网站接入微信登录(前端)
  20. html网页id怎么改成名字,IG 改名字:教你如何更改 Instagram 帐号名称 ID 及个人档案姓名...

热门文章

  1. 使用Python简单地去辅助百万答题
  2. 关于C++的数据模型:LP32、ILP32、LLP64、LP64
  3. 日紫白飞星算法_紫白飞星择日法
  4. P1717 Finger guessing
  5. 写个厦门市健身徒步爬山线路的web静态页面
  6. Pytorch TextCNN实现中文文本分类(附完整训练代码)
  7. 私域认知篇:私域流量到底是什么?私域流量现象,私域流量可以解决什么问题,如何开展私域流量?...
  8. tensorflow中将标注文件写到train.txt, test.txt,trainval.txt中
  9. HTMLCSS基础篇之十一:字体与颜色样式
  10. 2021年「质量员」-通用基础及岗位技能-考试题库及答案(三)