1. 基本语法

1.1. 基本语法

1.1.1. 标题与锚点

  1. 标题 在文本前添加『# 』即可创建标题。增加『# 』个数即可控制标题的级别,Markdown 共支持六级标题。

    注意:“#”只能位于某一行的开始处,并且在“#”与标题内容之间需要有一个空格。

  2. 锚点 锚点即文章内部超链接标记。针对每个标题,在解析时都会添加锚点 id,如: ### 1.1 标题与锚点 会被解析成: <h1 id="user-content-1.1 标题与锚点">1.1 标题与锚点</h1> 注意这里有一个 user-content- 的前缀,所以如果要自己添加跳转链接要使用 Markdown 的形式,且链接要加一个 user-content- 前缀,如: [1.1 标题与锚点](#user-content-1.1 标题与锚点) 但有些解析器没有添加“user-content-”前缀,可以直接使用“#”前缀即可引用链接: [1.1 标题与锚点](#11) 经markdown处理后为: 1.1 标题与锚点

1.1.2. 引用、强调、删除线与分割线

  1. 引用 只需要在整个段落的第一行最前面加上 『>』 即可: >Made by Paul

    Made by Paul

  2. 嵌套引用 区块引用可以嵌套,只要根据层次加上不同数量的『>』: > 第一级 > >> 第二级 > > 第一级

    第一级

    第二级

    第一级

注:引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等

  1. 强调(斜体或加粗) 使用 * 和 _ 来表示斜体和加粗:

    *斜体* _斜体_ **加粗** __加粗__ 斜体 斜体 加粗 加粗

  2. 删除线 使用 ~~ 表示删除线。例如: ~~ 我是删除线 ~~ 我是删除线

  3. 分割线 使用 3 个以上『-』符号单独在一行,制作分割线。

1.1.3. 链接与图片

  1. 链接 方括号中为链接说明,圆括号内编辑网址。

    如:[cakipaul.com](http://www.cakipaul.com) markdown处理后显示为:cakipaul.com

  2. 图片 Markdown内插入图片包含两种形式: 内联 和 引用。

  3. 内联图片语法如下: ![Alt text](/path/to/img.jpg)![Alt text](/path/to/img.jpg "Optional title") 即:以"!"开始,方括号里面是图片的替代文字,普通括号里面是图片的网址,最后还可以选择性添加引号包住的标题字段

  4. 引用图片语法如下: ![Alt text](url/to/image "Optional title attribute")

示例: ![baidu](https://www.baidu.com/img/baidu_jgylogo3.gif) baidu

1.1.4. 列表与表格

列表项目标记通常放在最左边,项目标记后面要接一个字符的空格。

  1. 无序表 在每行开头使用“*”、“+”或是“-”作为列表标记。

  2. 有序表 在每行开头使用数字接着一个英文句点。

  3. 列表内使用引用 如果要在列表项目内放进引用,那么引用符号『>』需要缩进

  4. 待办列表 代办列表: 表示列表是否勾选状态(注意: [ ] 前后都要有空格) - [ ]不勾选 - [x]勾选

  5. 表格 使用制表符制作表格。可以通过控制第二行中的---|---|---控制表格内容的对齐方式(两边对齐或居中)。如:

First Header | Second Header | Third Header
:-:|:--|--:
居中|左对齐|右对齐
Content Cell | Content Cell  | Content Cell
First Header Second Header Third Header
居中 左对齐 右对齐
Content Cell Content Cell Content Cell

注:有些markdown编辑器不支持对齐功能

1.1.5. 代码

  1. 单行代码 将代码放在` `之间即可

  2. 围栏式代码 代码块应包裹在两行 ``` 之间。在围栏式代码块中可以指定一个可选的语言标识符,就可以为代码启用语法着色了。例如: ```ruby require 'redcarpet' markdown = Redcarpet.new("Hello World!") puts markdown.to_html ``` 着色后为:

    require 'redcarpet'
    markdown = Redcarpet.new("Hello World!")
    puts markdown.to_html
    

results matching ""

    No results matching ""