11. Markdown 语法

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。Markdown是一种轻量级标记语言,目标是实现「易读易写」

标题

  • 在Markdown中,你只需要在文本前面加上# 即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加# 即可,标题字号相应降低。例如:
    # 一级标题
    ## 二级标题
    ### 三级标题
    #### 四级标题
    ##### 五级标题
    ###### 六级标题
    

锚点

  • Coding 会针对每个标题,在解析时都会添加锚点id,如:
    # 锚点
    
  • 会被解析成:
    <h1 id="user-content-锚点">锚点</h1>
    
  • 注意我们添加了一个user-content-的前缀所以如果要自己添加跳转链接要使用Markdown的形式,且链接要加一个 user-content- 前缀,如:
    [问内链接](#user-content-锚点);
    

引用

  • Markdown 标记区块引用是使用类似 email 中用 > 的引用方式,只需要在整个段落的第一行最前面加上 >
    > Coding.net 为软件开发者提供基于云计算技术的软件开发平台,包括项目管理,代码托管,运行空间和质量控制等等。
    
  • 区块引用可以嵌套,只要根据层次加上不同数量的 >
    > 这是第一级引用。
    >
    > > 这是第二级引用。
    >
    > 现在回到第一级引用。
    
  • 引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:
    > ## 这是一个标题。
    >
    > 1. 这是第一行列表项。
    > 2. 这是第二行列表项。
    >
    > 给出一些例子代码:
    >
    > return shell_exec("echo $input | $markdown_script");
    

列表

列表项目标记通常放在最左边,项目标记后面要接一个字符的空格。 无序列表:使用星号、加号或是减号作为列表标记

- Red
- Green
- Blue

有序列表:使用数字接着一个英文句点

1. Red
2. Green
3. Blue

如果要在列表项目内放进引用,那 > 就需要缩进:

*  Coding.net有以下主要功能:
    > 代码托管平台
    > 在线运行环境  
    > 代码质量监控  
    > 项目管理平台

代办列表: 表示列表是否勾选状态

- [ ] 不勾选
- [x] 勾选

代码

  • 只要把你的代码块包裹在 ``` 之间,你就不需要通过无休止的缩进来标记代码块了。 在围栏式代码块中,你可以指定一个可选的语言标识符,然后我们就可以为它启用语法着色了。 举个例子,这样可以为一段 Ruby 代码着色:
    require 'redcarpet'
    markdown = Redcarpet.new("Hello World!")
    puts markdown.to_html
    

强调

在Markdown中,可以使用 *_ 来表示斜体和加粗。

斜体:

*Coding,让开发更简单*
_Coding,让开发更简单_

加粗:

**Coding,让开发更简单**
__Coding,让开发更简单__

自动链接

  • 方括号显示说明,圆括号内显示网址, Markdown 会自动把它转成链接,例如:
    [Github首页](https://github.com/)
    
  • 或者也可以直接用 < >,将网址或者邮箱地址放在中间,也能将地址直接转成链接:
    <support@coding.net>
    

表格

  • 在 Markdown 中,可以制作表格,例如:
    First Header | Second Header | Third Header
    ------------ | ------------- | ------------
    Content Cell | Content Cell  | Content Cell
    Content Cell | Content Cell  | Content Cell
    
  • 或者也可以让表格两边内容对齐,中间内容居中,例如:
    First Header | Second Header | Third Header
    :----------- | :-----------: | -----------:
    Left         | Center        | Right
    Left         | Center        | Right
    

分割线

  • 在 Markdown 中,可以制作分割线,例如:
    --- 
    

上下标

  • \^ 表示上标, _ 表示下标。如果上下标的内容多于一个字符,要用 {} 把这些内容括起来当成一个整体。上下标是可以嵌套的,也可以同时使用。 例如:
    x^{y^z}=(1+{\rm e}^x)^{-2xy^w}
    

图片

  • Markdown 使用了类似链接的语法来插入图片, 包含两种形式: 内联 和 引用.
  • 内联图片语法如下:
    ![Alt text](/path/to/img.jpg)
    
  • ![Alt text](/path/to/img.jpg "Optional title")
    
  • 也就是一个感叹号: ! ; 紧跟一对方括号, 包含了可选填的图片 alt 属性; 紧跟一对圆括号, 包含了图片的 URL 或者路径, 以及一个可选的用单引号或双引号包裹的 title 属性.
  • 引用图片语法如下:
    ![Alt text][id]
    
  • “id” 是图片引用的名称. 图片引用使用链接定义的相同语法:
    [id]: url/to/image "Optional title attribute"
    

标题

---
title:标题
---
下一节:作者本人用 ubuntu/deepin 系统,所以这里的教程都用ubuntu/deepin 系统