Markdown是一种轻量级的标记语言,它的创始人是John Gruber。Markdown的语法特点是比较简洁易懂的,它的理念是让文档更加的容易读写和更改,我觉得人们在数十分钟内即可快速入门Markdown。以下内容是我的一个较为简单的学习总结。
Markdown最高支持六级标题,其语法格式为在标题文字前加入#和空格。在Typora里使用快捷键Ctrl+1可以实现一级标题的标注,余下的二级、三级等标题快捷键以此类推即可。
# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ####### 六级标题需要注意的是,当标题级别超过六级,即前方使用七个#,此时的语法已经不能再标注标题,输入的#######和正常的正文文本没有区别。
对于一级和二级标题,还可以使用如下方式进行显示。
一级标题 ==== 二级标题 ---Markdown通过使用*和_包围文本来实现文本的强调加粗和斜体显示,具体语法如下:
*斜体* 或者 _斜体_ **加粗文本** 或者 __加粗文本__ ***粗斜体文本*** 或者 ___粗斜体___这里的*和_和文本之间如果是有空白,那么它们不会起到应有的效果。如果确实需要在文本前后加入星号或者底线,可以考虑使用转义符进行实现。转义字符的用处在于,它保留了字符本该有的意义。
\*这是一段前后有星号的文字\*列表分为有序和无序两种,列表之间还可以进行组合嵌套。
在这里需要注意的是,在数字标注1.和后方列表项需要有一个空格进行隔开才能实现列表项,后面的无序列表的标注符号和列表项亦是如此。
无序列表前面的标注符号可为*、+和-。
* 列表项1 * 列表项2 + 列表项1 + 列表项2 - 列表项1 - 列表项2以上三种语法在编辑器中的结果均为:
列表项1列表项2Markdown编辑器中结果为:
产品功能 功能1功能2列表标注避免歧义:
当首行内容是以日期或者数字起始如:2015. 公司年度目标规划,此时为了避免其被转化为有序列表,我们可以在“.”前面加上反斜杠即转义字符来避免歧义。
2015\. 公司年度目标规划[ ]中的文本内容表示最终显示在编辑器里的文字
括号中的https://www.bing.com/是要跳转到的目标网页
“必应”表示鼠标悬停在此超链接时显示的文字
此时插入链接的效果如下:
bing
注: Markdown本身语法不支持连接在新的页面打开,csdn页面点击后网页还是打不开,这里如果要实现跳转,可以使用HTML语言来实现同样的效果。语法如下:
<a href="https://www.bing.com/" target='_blank'>bing</a>使用HTML添加的链接即是可以实现跳转的了: bing
结果是:
这是一篇markdown的学习笔记。
如果需要高亮的内容本身包含" ` ",则是可以这样来写:
`` `这里` ``Markdown支持多种语言的语法高亮,如需要在文本中加入代码块,可使用如下示例语法:
```python import pandas as pd ``` ```html <div>Syntax Highlighting</div> ``` ```java println('Hello world!') ```以上语法高亮效果如下:
import pandas as pd <div>Syntax Highlighting</div> println('Hello world!')Markdown支持的代码高亮远不止这些,其余的代码高亮功能还需要读者自行尝试,按照类似的方法,变换语法名称即可。
在Markdown语法中,在需要引用的文字前加入>即可实现引用效果。语法示例如下:
> 这是一段很长的文字。结果如下:
这是一段很长的文字。
Markdown的引用可以实现嵌套效果,语法如下:
> 这是第一层文字。 >> 这是第二层文字。结果如下:
这是第一层文字。
这是第二层文字。
Markdown可使用*或者是-来实现一条“华丽的分割线”,具体语法如下:
*** * * * - - -结果均为一条分割线,如下所示:
Markdown其实也支持传统的HTML标签,我们在引用的时候也可以写成:
<blockquote>这是使用html语法实现的引用效果</blockquote>我们可以看到,这里使用HTML语法实现的效果是相同的:
这是使用html语法实现的引用效果这些是本人对Markdown语法的学习笔记和总结,也是本人的第一篇博客。多有不足之处还请各位读者包涵。