本文转自 https://nepton.github.io/blog/markdown/markdown-grammar
作者:nepton
本文采用 Creative Commons BY-NC-ND 许可协议,版权归作者所有。 欢迎转载,但必须保留此段声明且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。 感谢您的支持,这是对我最大的鼓励。
想5分钟学会使用 Markdown 的标记语法?集中你的注意力,往下看。如果你是一名技术工作者,你会发现 Markdown 的语法简直是世界上最简单的语法了。如果你是一名作家,担心所谓的“标记”语言?别担心,我保证你5分钟,就学会了。
语法主要分为字体控制:
粗体:使用 **
斜体:使用 _
标题:使用 #
引用:使用 >
横线: 使用 —
列表:使用 * 或者 1. 2. 3.
链接:使用
图片:使用
段落:敲回车,或者敲空格
对于技术人员,你还需要引用代码块,
代码块: 使用 `
多行代码块: 使用 ```
没有了,到此结束
当然还有很多社区志愿者扩展了这些符号,例如绘制表格、删除线、页内跳转、注释等等,这些使用频率较低,我将在以后博文中讲解。
粗体和斜体
我们首先学习文本格式中的两个基本元素:粗体和斜体。
红色内容
您会注意到一些格式化的 红色内容,这些内容是含有Markdown排版格式的内容,为了提醒您的注意,因此把这些文本标记为红色突出显示,请注意这些内容中非同寻常的符号与排版,Markdown 就是通过他们让您的文章井井有条。
您在排版时候,需要创建一个斜体,怎么做呢?在 Markdown 中这很简单,您只需要需要斜体化的文字两侧添加下划线(_)或者星号(*)。 例如,你好 或者 你好 将变为斜体。简单吧,变为斜体就是这样简单。
如果要把文字变为粗体,只需要在这些文字两侧添加双星号(), 例如我非常喜欢**去吃海鲜!
当然,你可以同时把文字变为 粗体 和 斜体,只需要把这些符号都加上! 比如:我周末要陪 孩子 去公园玩!通常,先写星号或下划线的顺序无关紧要。
标题
我们来看看这个重量级的家伙——标题。文章需要分章节,在这时,标题就可以大显身手。他为每一章节的内容取一个名字,醒目的显示出以下内容是什么。
标题有六种类型,从大到小分别为:
标题示例
要在Markdown中创建标题,请在标题内容前添加一个井号(#),一级标题放一个井号(#),二级标题放两个井号(##),三级标题放三个井号(###),以此类推。
同时,标题的内容中可以增加星号或者下划线更改标题内容的样式。
引用
如果您要引用一段内容,或者如果您需要读者特别关注一句话,那么使用Markdown的引用语法将非常有用。使用了引用的内容,将会出现特别格式化的句子或段落,以引起读者的注意。例如:
买好的,更要买的好。
要创建这样一段引用块,您只需要在这行话前,添加一个大于号(>)就行,例如上一句内容 Markdown 语法如下:
买好的,更要买的好。
横线
有时候您需要在文章中添加一条漂亮的横线作为分隔,如果要绘制一条横线,只需要在单独一行内,输入三个相同的星号(***)、三个相同的减号(—)或者三个相同的下划线(___)就行。
不过有一点需要注意,这一行不要再添加其他内容。
列表
列表分为两种,一种是以一个“点”开头的无顺序列表,另一种是以数字开头的有序列表。
无顺序列表在列表项的每一行开头,添加一个星号(*),加号(+)或者减号(-),例如:
理解风险
识别风险
控制风险
我们是这样实现上边这个列表的:
- 理解风险
- 识别风险
- 控制风险
如果要实现一个有序的列表,在每一行的开头添加一个数字,外加一个点(1.)即可,上边这个无序列表经过改造后,变成以下有序列表:
理解风险
识别风险
控制风险
实现的方法如下:
- 理解风险
- 识别风险
- 控制风险
如果要实现嵌套的列表,嵌套的可以通过列表缩进一些空格实现,这里您要问了,你说的 “一些空格” 是多少呢?”一些” 的数量要看情况,对于”1. “、”2. “、”3. “ 的情况是3个空格,对于 “* “、”+ “ 的情况是2个空格,这里的原则是:使用空格缩进后保证新行的起始于上一行的正文区域,
indent_example
上面的例子中,”* 风险是什么”的星号对齐上一行的正文第一个字”理”,markdown则认为这是一个新的缩进,以此类推,您以后就能够自由灵活的控制缩进了。
链接
如果您要创建一个鼠标可以点击的文字,用户点击后跳转到另一个网址,您就要用到链接。在Markdown中,链接非常简单,最简单的链接,就是直接把网址完整的粘贴到页面中即可,例如:https://nepton.github.io,您点点看,点击以后,您的浏览器的页面是不是就跳转到我的首页了。
您要说,很多人制作的链接不是这样乱七八糟的英文字母,而是通俗易懂的网站名,没关系,哈哈,这么做,把您刚才输入的网址用一对小括号括起来,在左括号的前边,给这个网址取一个名字,再用中括号把这个名字也括起来,就大功告成,做完后是这样子的:[豆豆的故事](https://nepton.github.io)
,您来点一下 豆豆的故事 试试看,是不是一样的效果呀。
图片
显示图片的原理跟显示链接差不多,因为图片本身也是一个链接嘛,所以格式几乎一模一样,区别仅仅在于,在链接格式的最左边,再加一个感叹号(!)。
完整的格式是:![图片名](https://........你图片的网址.........)
。
我们马上做一个,我们给图片取个名字叫”我的图片”,地址为:https://picsum.photos/500/300, 这是一个专门提供图片的网站,我们仅拿这个链接做测试。好了,完整的格式如下:
![我的图片](https://picsum.photos/500/300)
看看效果是什么样的,怎么样,是不是 Markdown 很简单。
我的图片
段落
段落就是敲回车,让两段话之间空出一个空行。Markdown 会自动的把内容分割为两端话,如果您敲了回车后,新段落前没有单独空一行,就不算新分段。您看下边的例子:
从前,有个国王和王后,他们很富有,简直享有一切他们所希望的东西,只是没有孩子。 王后为此日夜伤感,说:“我就像块不长庄稼的地。”。
以上2行原文之间有一个回车分隔,但是新段落前没有单独空行,因此 Markdown 认为自一段话,显示效果如下:
从前,有个国王和王后,他们很富有,简直享有一切他们所希望的东西,只是没有孩子。 王后为此日夜伤感,说:“我就像块不长庄稼的地。”。
如果在两行之间,插入一个空白行,就成为了两段话,您看,原文第二行现在是空白的一行,此时 Markdown则认为这是两段话。
从前,有个国王和王后,他们很富有,简直享有一切他们所希望的东西,只是没有孩子。 王后为此日夜伤感,说:“我就像块不长庄稼的地。”。
以上内容Markdown显示的结果为:
从前,有个国王和王后,他们很富有,简直享有一切他们所希望的东西,只是没有孩子。
王后为此日夜伤感,说:“我就像块不长庄稼的地。”。
有些时候,您要写一首小诗,都是一行一句的,但是又不想通过分段分隔,因为那样插入空行后,行与行之间的间距很大,会很难看,这时候要怎么办呢?
如果是这样的情况,请保留小诗一行一句的格式,然后,在每一行的末尾增加两个空格,试试看,是不是得到了漂亮的排版?
灵台无计逃神矢,
风雨如磐暗故园。
寄意寒星荃不察,
我以我血荐轩辕。
—— 鲁迅
恭喜您
恭喜您,您此时可以正式开始使用 Markdown 书写您的文章或者博文了,基本的用法就这些,您花费了5分钟时间阅读本文学习到了Markdown的使用,会让您以后在写作时受益匪浅。如果您需要继续了解学习Markdown的更多用法。我会在以后的博文中深入讲解。
在这里给您推荐一些有用的Markdown网站,
https://www.markdowntutorial.com 由 gjtorikian 提供的在线教程非常棒。
http://en.wikipedia.org/wiki/Markdown Wiki 提供的Markdown介绍。
https://www.markdownguide.org 提供了Markdown的基本语法和扩展语法介绍。