markdown语法教程

markdown语法教程

Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的HTML(超文本标记语言)。Markdown语法简洁明了,易于学习和使用。以下是Markdown语法的详细教程:

一、基础语法

  1. 标题

    Markdown支持六级标题,使用1~6个井号(#)表示不同级别的标题。例如:

    # 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题
  2. 文本

    • 普通文本:直接编写的文字即为普通文本。
    • 斜体文本:在文字前后各加一个星号(*)或下划线(_)即可。例如:斜体文本斜体文本
    • 粗体文本:在文字前后各加两个星号()或下划线(__)即可。例如:粗体文本** 或 粗体文本
    • 删除线文本:在文字前后各加两个波浪线()即可。例如:删除线文本~~。
    • 标记文本:在文字前后各加两个等号(==)即可。
    • 下角标和上角标:使用“”表示下角标,使用“^”表示上角标。例如:H2~O、X^2^。
  3. 换行

    Markdown中不能直接换行,需要在上一段文字后面加两个空格再回车,或者直接按两次回车换行(类似于换段落)。

  4. 分割线

    可以在一行中使用三个以上的星号(*)、减号(-)或底线(_)来建立一个分隔线,行内不能有其他东西。例如:

    *** * * * ***** --- - - - ----------
  5. 列表

    • 无序列表:使用星号(*)、加号(+)或减号(-)作为列表标记,这些标记后面要添加一个空格。例如:

      * 项目1 + 项目2 - 项目3
    • 有序列表:使用数字并加上英文句点(.)来表示。例如:

      1. 第一项 2. 第二项 3. 第三项
    • 嵌套列表:在子列表中的选项前面添加两个或四个空格即可实现嵌套。

  6. 引用

    在段落开头使用大于号(>)符号,然后后面紧跟一个空格符号,即可创建区块引用。引用可以嵌套,一个>符号是最外层,两个>符号是第一层嵌套,以此类推。例如:

    > 这是区块引用 > > 这是嵌套引用
  7. 代码

    • 行内代码:使用反引号()将代码包裹起来。例如:printf()`函数。

    • 代码区块:使用四个空格或一个制表符(Tab键)缩进代码,或者使用三个反引号(```)包裹一段代码,并可以指定一种语言(也可以不指定)。例如:

      ```c++ #include <stdio.h> int main() { return 0; }

二、高级语法

  1. 链接

    Markdown支持两种形式的链接:行内式和参考式。

    • 行内式链接:使用方括号([])包裹链接名称,后面紧跟圆括号(())包裹链接地址。例如:百度。

    • 参考式链接:在文档其他地方定义链接变量,然后在需要插入链接的地方使用方括号([])包裹链接名称,并在文档末尾为变量赋值(网址)。例如:

      这个链接用url1作为网址变量[Google][url1] [url1]: http://www.google.com/
  2. 图片

    Markdown图片语法格式是:![alt 属性文本](图片地址)或![alt 属性文本](图片地址 "可选标题")。例如:

    ![美丽天空](https://example.com/image.jpg)
  3. 表格

    Markdown支持创建表格,使数据的展示更加整齐有序。表格分为表头和表体,表头使用|分隔各个单元格,并在下方添加由-组成的分割线。例如:

    | 产品 | 价格 | | --- | --- | | 电脑 | 1600 | | 手机 | 1200 | | 电视 | 4000 |
  4. 脚注

    脚注用于对文本的补充说明,格式类似于超链接。在需要添加脚注的文字后加上脚注名字(使用[^]标记),然后在文档的任意位置(一般在最后)添加脚注内容,脚注内容前必须有对应的脚注名字。例如:

    这是一个有脚注的文本[^1] [^1]: 这是脚注的内容
  5. HTML标签

    Markdown支持内嵌HTML标签,因此可以使用HTML来实现一些Markdown不支持的功能,如设置背景色等。例如:

    <table><tr><td bgcolor=orange>背景色是:orange</td></tr></table>
  6. 特殊符号

    Markdown中的语法符号,如星号(*)、反引号(`)等,如果要在文本中表示这些符号本身,可以在其前面加上反斜线(\)进行转义。此外,Markdown还支持一些特殊的字符和Unicode码。

  7. Emoji表情符号

    Markdown支持Emoji表情符号的使用,格式为:EMOJICODE:。不过,需要注意的是,并非所有的Markdown编辑器或网站都支持Emoji表情符号。

三、常用技巧

  1. 快捷键

    在一些Markdown编辑器中,可以使用快捷键来快速应用Markdown语法。例如,加粗(Ctrl+B)、斜体(Ctrl+I)、插入链接(Ctrl+L)等。

  2. 字体、字号与颜色

    Markdown本身不支持修改字体、字号与颜色等功能,但可以通过内嵌HTML的方法来实现这些效果。例如,使用<font>标签来设置字体、字号和颜色。

  3. 背景色设置

    由于Markdown本身不支持背景色设置,因此需要使用HTML标签来实现。如上所述,可以借助<table>、<tr>、<td>等表格标签的bgcolor属性来实现背景色的功能。

  4. 目录生成

    在一些Markdown编辑器中,可以使用特定的语法来自动生成文档的目录。例如,在文档的开头或任意位置插入@[TOC](目录标题),编辑器会自动把文档中所有用#打出的标题归纳到目录中。

Markdown语法简洁而强大,通过掌握这些基础和高级语法以及常用技巧,可以更加高效地编写和格式化文档。