中文文案寫作標準

1
2
3
4
5
6

一級標題 #
二級標題 ##
三級標題 ###
四級標題 ####
五級標題 #####
六級標題 ######

1
2
3
4
5

段落 1(文本之間空一行即為產生一個段落)

段落 2(文本之間空一行即為產生一個段落)

段落 2(文本之間空一行即為產生一個段落)

1
2
3

> 引用的內容
> 引用的內容
> 引用的內容

1
2
3
4

1. 文本
2. 文本
3. 文本
4. 文本

1
2
3
4
5

- 文本
- 文本

* 文本
* 文本

1

`print("Hello word!")`

1
2
3
4
5

````python
def sum(x, y):
	return x + y
\```
````

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

#### 加粗

對應 HTML 語言中的`<strong>`標籤。

```markdown
**加粗的文字**
普通文字
```

#### 傾斜

對應 HTML 語言中的`<em>`標籤。

```markdown
_傾斜的文字_
普通文字
```

#### 高亮

對應 HTML 語言中的`<mark>`標籤。

```markdown
==高亮文本==
普通文本
```

#### 刪除線

對應 HTML 語言中的`<del>`標籤。

```markdown
~~刪除線~~
```

#### 分隔線

對應 HTML 語言中的`<hr>`標籤。

```markdown
---

---
```

####鏈接

對應 HTML 語言中的`<a>`標籤。

```markdown
![描述](http://example.com/)
<http://example.com/>
```

#### 圖片

對應 HTML 語言中的`<img>`標籤。

```markdown
[描述](http://example.com/example.jpg)
```

#### 表格

對應 HTML 語言中的`<table>`、`<tr>`、`<td>`標籤。

```markdown
| 表標題 1 | 表標題 2 | 表標題 3 |
| -------- | -------- | -------: |
| 數據 1   | 數據 2   |   數據 3 |
| 數據 4   | 數據 5   |   數據 6 |
```

## 寫作工具

### Markdown 編輯器

1. Ulysses（僅支持 Mac 和 iOS）
2. Typroa（支持 Mac，PC 和 Linux）

### 純文本編輯器

1. Visual Studio Code（支持 Mac，PC 和 Linux）
2. Sublimtext（支持 Mac，PC 和 Linux）

## 寫作規範

### 段落

- 文字頂格寫，不要留空格。
- 純文本，段落之間留一個空行，以區分段落。
- 富文本，按照格式設定，確保不同段落文字之間在視覺上存在差異。

### 標點

- 中英文混排，一律使用中文標點。
- 中英文混排出現整句英文，英文中使用英文標點。
- 使用直角引號「」或『』。

### 中文與英文、數字混排時的空格

- 英文、數字與非標點中文文字之間有一個空格。如「XXX 說明第 1 版」，錯誤示例~~「XXX 隱私政策第 1 版」~~。
- 英文、數字與中文標點之間不加空格。

> 漢學家稱這個空格為「盤古之白」，因為它劈開了全形字和半形字之間的混沌。
>
> 另有研究顯示，打字的時候不喜歡在中文和英文之間加空格的人，感情路都走得很辛苦，有七成的比例會在 34 歲的時候跟自己不愛的人結婚，而其餘三成的人最後只能把遺產留給自己的貓。畢竟愛情跟書寫都需要適時地留白。
>
> ——[vinta/pangu.js 為什麼你們就是不能加個空格呢？](https://github.com/vinta/pangu.js)

### 引用

- 如果在正文中部分引用第三方內容，請使用恰當的引用格式並給出出處。如：

> Stay Hungry, Stay Foolish. — Whole Earth Catalog

- 如果是全篇轉載，在全文開頭顯示位置註明出處並給出原文鏈接。如：

  > 本文轉載自 Wikipedia：[Demark](https://en.wikipedia.org/wiki/Denmark)

- 如果格式不允許超鏈接，請以文本方式直接給出原文鏈接。如：

  > 本文轉載自 Wikipedia - Denmark：https://en.wikipedia.org/wiki/Denmark

## 寫作風格

- 簡潔
- 準確
- 易讀

## 参考资料

- 阮一峰：[中文技术文档的写作规范](https://github.com/ruanyf/document-style-guide)
- LeanCloud：[文案风格指南](http://open.leancloud.cn/copywriting-style-guide.html)