Markdown语法快速入门学习笔记

    技术2022-07-10  99

    文章目录

    Markdown简介语法入门标题文本强调列表有序列表无序列表列表间的组合 链接代码和语法高亮行内代码语法高亮 引用水平分割线补充 总结

    Markdown简介

    Markdown是一种轻量级的标记语言,它的创始人是John Gruber。Markdown的语法特点是比较简洁易懂的,它的理念是让文档更加的容易读写和更改,我觉得人们在数十分钟内即可快速入门Markdown。以下内容是我的一个较为简单的学习总结。

    语法入门

    标题

    Markdown最高支持六级标题,其语法格式为在标题文字前加入#和空格。在Typora里使用快捷键Ctrl+1可以实现一级标题的标注,余下的二级、三级等标题快捷键以此类推即可。

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

    需要注意的是,当标题级别超过六级,即前方使用七个#,此时的语法已经不能再标注标题,输入的#######和正常的正文文本没有区别。

    对于一级和二级标题,还可以使用如下方式进行显示。

    一级标题 ==== 二级标题 ---

    文本强调

    Markdown通过使用*和_包围文本来实现文本的强调加粗和斜体显示,具体语法如下:

    *斜体* 或者 _斜体_ **加粗文本** 或者 __加粗文本__ ***粗斜体文本*** 或者 ___粗斜体___

    这里的*和_和文本之间如果是有空白,那么它们不会起到应有的效果。如果确实需要在文本前后加入星号或者底线,可以考虑使用转义符进行实现。转义字符的用处在于,它保留了字符本该有的意义。

    \*这是一段前后有星号的文字\*

    列表

    列表分为有序和无序两种,列表之间还可以进行组合嵌套。

    有序列表

    1. 列表项1 2. 列表项1 3. 列表项1

    在这里需要注意的是,在数字标注1.和后方列表项需要有一个空格进行隔开才能实现列表项,后面的无序列表的标注符号和列表项亦是如此。

    无序列表

    无序列表前面的标注符号可为*、+和-。

    * 列表项1 * 列表项2 + 列表项1 + 列表项2 - 列表项1 - 列表项2

    以上三种语法在编辑器中的结果均为:

    列表项1列表项2

    列表间的组合

    * 产品介绍 下方的子项需要以一个制表符或者4个空格缩进之后再书写列表项前方标注 * 产品功能 1. 功能1 2. 功能2

    Markdown编辑器中结果为:

    产品功能 功能1功能2

    列表标注避免歧义:

    当首行内容是以日期或者数字起始如:2015. 公司年度目标规划,此时为了避免其被转化为有序列表,我们可以在“.”前面加上反斜杠即转义字符来避免歧义。

    2015\. 公司年度目标规划

    链接

    [bing](https://www.bing.com/ "必应")

    [ ]中的文本内容表示最终显示在编辑器里的文字

    括号中的https://www.bing.com/是要跳转到的目标网页

    “必应”表示鼠标悬停在此超链接时显示的文字

    此时插入链接的效果如下:

    bing

    注: Markdown本身语法不支持连接在新的页面打开,csdn页面点击后网页还是打不开,这里如果要实现跳转,可以使用HTML语言来实现同样的效果。语法如下:

    <a href="https://www.bing.com/" target='_blank'>bing</a>

    使用HTML添加的链接即是可以实现跳转的了: bing

    代码和语法高亮

    行内代码

    这是一篇`markdown`的学习笔记。

    结果是:

    这是一篇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语法的学习笔记和总结,也是本人的第一篇博客。多有不足之处还请各位读者包涵。

    Processed: 0.015, SQL: 9