Markdown 教程


# Guide



这是一篇讲解如何正确使用 **Markdown** 的排版示例,学会这个很有必要,能让你的文章有更佳清晰的排版。

> 引用文本:Markdown is a text formatting syntax inspired


## 语法指导



### 普通内容

这段内容展示了在内容里面一些小的格式,比如:



- **加粗** - `**加粗**`

- *倾斜* - `*倾斜*`

- ~~删除线~~ - `~~删除线~~`

- `Code 标记` - ``Code 标记``

- [超级链接](http://github.com) - `[超级链接](http://github.com)`

- [username@gmail.com](mailto:username@gmail.com) - `[username@gmail.com](mailto:username@gmail.com)`



### 提及用户

@Vanessa ... 通过 @ 可以在发帖和回帖里面提及用户,信息提交以后,被提及的用户将会收到系统通知,以便让他来关注这个帖子或回帖。


> NOTE:
>
> 1. @用户名之后需要有一个空格
> 2. 新手没有艾特的功能权限




### 表情符号 Emoji

支持大部分标准的表情符号,可使用输入法直接输入,也可手动输入字符格式。欢迎通过快捷键 `Ctrl+/` 自动完成进行输入,并在个人设置中[设置常用表情](https://hacpai.com/settings/function)。


#### 一些表情例子

:smile: :laughing: :dizzy_face: :sob: :cold_sweat: :sweat_smile:  :cry: :triumph: :heart_eyes: :relaxed:
:+1: :-1: :100: :clap: :bell: :gift: :question: :bomb: :heart: :coffee: :cyclone: :bow: :kiss: :pray: :anger:

### 大标题 - Heading 3

你可以选择使用 H1 至 H6,使用 ##(N) 打头。

> NOTE: 别忘了 # 后面需要有空格!


#### Heading 4

##### Heading 5

###### Heading 6



### 图片

```
![alt 文本](http://image-path.png)
![alt 文本](http://image-path.png "图片 Title 值")
![设置图片宽度高度](http://image-path.png =300x200)
![设置图片宽度](http://image-path.png =300x)
![设置图片高度](http://image-path.png =x200)
```

支持复制粘贴直接上传 :)


### 代码块


#### 普通

```
*emphasize*    **strong**
_emphasize_    __strong__
var a = 1
```

#### 语法高亮支持

如果在 ``` 后面更随语言名称,可以有语法高亮的效果哦,比如:


##### 演示 Go 代码高亮


```go
package main

import "fmt"

func main() {
	fmt.Println("Hello, 世界")
}
```


##### 演示 Java 高亮


```java
public class HelloWorld {

    public static void main(String[] args) {
        System.out.println("Hello World!");
    }

}
```

> Tip: 语言名称支持下面这些: `ruby`, `python`, `js`, `html`, `erb`, `css`, `coffee`, `bash`, `json`, `yml`, `xml` ...


### 有序、无序列表


#### 无序列表


- Java
  - Spring
    - IoC
- Go
  - gofmt
  - Wide
- Node.js
  - Koa
  - Express








#### 有序列表


1. Node.js
  1. Express
  2. Koa
  3. Sails
2. Go
  1. gofmt
  2. Wide
3. Java
  1. Latke
  2. IDEA







### 表格

如果需要展示数据什么的,可以选择使用表格。



| header 1 | header 3 |
| -------- | -------- |
| cell 1   | cell 2   |
| cell 3   | cell 4   |
| cell 5   | cell 6   |




### 段落


留空白的换行,将会被自动转换成一个段落,会有一定的段落间距,便于阅读。

请注意后面 Markdown 源代码的换行留空情况。


### 排版

请注意单词拼写,以及中英文排版,[https://github.com/sparanoid/chinese-copywriting-guidelines](https://github.com/sparanoid/chinese-copywriting-guidelines),特别是关于空格的使用。

## 快捷键

我们的编辑器支持很多快捷键,具体请参考 [键盘快捷键](https://hacpai.com/article/1474030007391)(或者按 `?` :smirk_cat:)
                            

Guide

这是一篇讲解如何正确使用 Markdown 的排版示例,学会这个很有必要,能让你的文章有更佳清晰的排版。

引用文本:Markdown is a text formatting syntax inspired

语法指导

普通内容

这段内容展示了在内容里面一些小的格式,比如:

  • 加粗 - **加粗**

  • 倾斜 - *倾斜*

  • 删除线 - ~~删除线~~

  • Code 标记 - Code 标记

  • 超级链接 - [超级链接](http://github.com)

  • username@gmail.com - [username@gmail.com](mailto:username@gmail.com)

提及用户

@Vanessa ... 通过 @ 可以在发帖和回帖里面提及用户,信息提交以后,被提及的用户将会收到系统通知,以便让他来关注这个帖子或回帖。

NOTE:

  1. @用户名之后需要有一个空格
  2. 新手没有艾特的功能权限

表情符号 Emoji

支持大部分标准的表情符号,可使用输入法直接输入,也可手动输入字符格式。欢迎通过快捷键 Ctrl+/ 自动完成进行输入,并在个人设置中设置常用表情

一些表情例子

smile laughing dizzy_face sob cold_sweat sweat_smile cry triumph heart_eyes relaxed
+1 -1 100 clap bell gift question bomb heart coffee cyclone bow kiss pray anger

大标题 - Heading 3

你可以选择使用 H1 至 H6,使用 ##(N) 打头。

NOTE: 别忘了 # 后面需要有空格!

Heading 4

Heading 5
Heading 6

图片

![alt 文本](http://image-path.png)
![alt 文本](http://image-path.png "图片 Title 值")
![设置图片宽度高度](http://image-path.png =300x200)
![设置图片宽度](http://image-path.png =300x)
![设置图片高度](http://image-path.png =x200)

支持复制粘贴直接上传 :)

代码块

普通

*emphasize*    **strong**
_emphasize_    __strong__
var a = 1

语法高亮支持

如果在 ``` 后面更随语言名称,可以有语法高亮的效果哦,比如:

演示 Go 代码高亮
package main

import "fmt"

func main() {
    fmt.Println("Hello, 世界")
}
演示 Java 高亮
public class HelloWorld {

    public static void main(String[] args) {
        System.out.println("Hello World!");
    }

}

Tip: 语言名称支持下面这些: ruby, python, js, html, erb, css, coffee, bash, json, yml, xml ...

有序、无序列表

无序列表

  • Java
    • Spring
      • IoC
  • Go
    • gofmt
    • Wide
  • Node.js
    • Koa
    • Express

有序列表

  1. Node.js
    1. Express
    2. Koa
    3. Sails
  2. Go
    1. gofmt
    2. Wide
  3. Java
    1. Latke
    2. IDEA

表格

如果需要展示数据什么的,可以选择使用表格。

header 1 header 3
cell 1 cell 2
cell 3 cell 4
cell 5 cell 6

段落

留空白的换行,将会被自动转换成一个段落,会有一定的段落间距,便于阅读。

请注意后面 Markdown 源代码的换行留空情况。

排版

请注意单词拼写,以及中英文排版,https://github.com/sparanoid/chinese-copywriting-guidelines,特别是关于空格的使用。

快捷键

我们的编辑器支持很多快捷键,具体请参考 键盘快捷键(或者按 ? smirk_cat