关于Markdown,它可以说是程序员公认最好的文档语言了,没有之一!我相信经常写文章或者开发文档的大佬们都对其能生成简洁、大方、雅观的文档都深有体会,它的强大是毋庸置疑的。它编写的文档不但能生成html格式的文档,还可以生成pdf格式的文档。而且现在网上的在线编辑器几乎上都支持了Markdown语法。比如:Github、GitLab、掘金、简书、博客园、csdn、码云、有道云笔记...等等,这里就不在一一列举了。反正大家只要知道它很简洁、通用、强大就够了。
这是我以前学习Markdown语法的笔记,对着电脑无聊之下发现了其存在,而前不久还有一个朋友问我其语法,或许不会Markdown语法的同学还是有一部的。故而,这里整合以前自己的笔记分享给大家,希望大家会喜欢。
目录 一、Markdown简介既然我们用了它,就该对其有一个大概的了解
1.1、认识MarkdownMarkdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑,Markdown的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的HTML标记语言来说,Markdown可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。
它用简洁的语法代替排版,而不像一般我们用的字处理软件Word或Pages有大量的排版、字体设置。它使我们专心于码字,用「标记」语法,来代替常见的排版格式。
1.2、使用Markdown的好处专注你的文字内容而不是排版样式。
轻松的导出 HTML、PDF 和本身的 .md 文件。
纯文本内容,兼容所有的文本编辑器与字处理软件。
可读,直观。适合所有人的写作语言。
二、Markdown语法规则上面对Markdown有了一个基本的认识,并且对其使用的好处也介绍了几点。那么该怎样编写Markdown文档呢?请继续往下看...
2.1、标题类似于word文档中的标题。并且该标题的级数对应于Html语言的标题标签级数。如<h1></h1>、<h2></h2>...
一级标题:使用1个`#`号。 例: # 一级标题 等价于html中的 <h1>一级标题</h1> 二级标题:使用2个`#`号。 例: ## 二级标题 等价于html中的 <h2>二级标题</h2> 三级标题:使用3个`#`号。 例: ### 三级标题 等价于html中的 <h3>三级标题</h3> 四级标题:使用4个`#`号。 例: #### 四级标题 等价于html中的 <h4>四级标题</h4> 五级标题:使用5个`#`号。 例: ##### 五级标题 等价于html中的 <h5>五级标题</h5> 六级标题:使用6个`#`号。 例: ###### 六级标题 等价于html中的 <h6>六级标题</h6>举例说明:
# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题看下效果:
一级标题 二级标题 三级标题 四级标题 五级标题 六级标题 2.2、列表在编写Markdown文档时,列表几乎上都会用到的,而列表可分为无序列表和有序列表两种,他们的语法都很简单
2.2.1、有序列表要使用有序列表,只要在一段文字前加上序号即可。如1. xxx、2. xxx...,这里值得注意的是,序号后面跟上一个英文符号的点(.),并且(.)后面有一个空格,不然无效。
举例说明:
1. 中国 2. 美国 3. 英国看下效果
中国
美国
英国
2.2.2、无序列表要是用无序列表,只要在一段文字前面加上特定的符号即可。这里的符号可以是(*、-、+)。如- xxx、+ xxx、* xxx。同样值得注意的是符号与文字之间有一个空格。
举例说明:
- 中国 + 中国 * 中国 - 美国 <===> + 美国 <===> * 美国 - 英国 + 英国 * 英国上面三个符号的效果是一样的,并且可以混用。看下效果:
中国
美国
英国
2.2.3、有序列表和无序列表之间的混用情况在实际编写中,可能会出现列表包含子列表的情况,也可能发生无序与有序列表之间嵌套的情况。这种情况下,只要在子列表的字段前面加上一个Tab键,即4个空格就行了。请看下面的实例。
1. 中国 - 深圳 - 上海 2. 美国 - 纽约 - 硅谷 3. 英国 - 英格兰 - 威尔士看下效果:
中国
深圳
上海
美国
纽约
硅谷
英国
英格兰
威尔士
上面只演示了,有序列表嵌套无序列表的情况,其他的根据这个格式按照有序和无序列表的语法改动就行了。
2.3、引用引用的使用:在一段文本的前面加上英文的右尖括号,即(>)符号。值得注意的是,>符号与文本之间有一个空格。
2.3.1、基本使用举例说明:
> 我是引用文本看小效果:
我是引用文本
2.3.2、嵌套引用嵌套引用在一个引用文本中在引用其他的文本,也可以和列表一起使用