Markdown 教程 - 乾学院

Markdown 教程

# Guide

This Guide shows you how to use **Markdown** appropriately to format text at Raqsoft College. This will make it easier for users to creat a clear layout.

> Referenced text：Markdown is a text formatting syntax inspired

## Syntax

### General

Here are some formatting techniques Markdown uses, such as:

- **Bold** - `**Bold**`

- *Italics* - `*Italics*`

- ~~Strikethrough~~ - `~~Strikethrough~~`

- `Code` - ``Code``

- [Links](http://github.com) - `[Links](http://github.com)`

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

### Mention a user

@Vanessa ... Type @ before a user name to direct a message to this user in a post or a reply. After the message is submitted, the mentioned user will receive a notification.

> NOTE:
>
> 1. There is a space between @ and the user name.
> 2. A new user can't mention another user.

### Emoji

We support most of the Emojis. You can enter one using an IME, or type an Emoji chart format. You are also welcomed to automatically enter an Emoji using the shortcut key `Ctrl+/`, and set your own Emojis in My settings. (https://hacpai.com/settings/function)

#### Some of the Emojis:

: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:

### Headings - Heading 3

There are 6 heading levels: h1-h6. To create a heading, add number signs (#) in front of a word or phrase. The number of number signs should correspond to the heading level.

> NOTE: There is a space between the number sign and the word or phrase.

#### Heading 4

##### Heading 5

###### Heading 6

### Images

```
![alt text](http://image-path.png)
![alt text](http://image-path.png "Logo Title Text")
![Set image width & height](http://image-path.png =300x200)
![Set image width](http://image-path.png =300x)
![Set image height](http://image-path.png =x200)
```

You can also copy an image to upload :)

### Code Blocks

#### General

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

#### Syntax Highlighting

Write a language name after the three back-ticks (```) to achive syntax highlighting. For example:

##### For Go language:

```go
package main

import "fmt"

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

##### For Java：

```java
public class HelloWorld {

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

}
```

> Tip: These languages support syntax highlighing: `ruby`, `python`, `js`, `html`, `erb`, `css`, `coffee`, `bash`, `json`, `yml`, `xml` ...

### Ordered & Unordered Lists

#### Unordered Lists

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

#### Ordered Lists

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

### Tables

Use a table to present data.

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

### Paragraphs

You can add a space to make the next list item another paragraph as needed.
Note how to create a space using the Markdown source code.

### Mathematical Formulas
$$a^2 + b^2 = \color{red}c^2$$

### Flowchart

```flow
st=>start: Start
op=>operation: Your Operation
cond=>condition: Yes or No?
e=>end

st->op->cond
cond(yes)->e
cond(no)->op
```