matro.jpg 1.标题1.1层级标题分为四级。
下面是示例。 # 一级标题## 二级标题### 三级标题#### 四级标题 1.2原则(1)一级标题下,不能直接出现三级标题。 示例:下面的文章结构,缺少二级标题。
(2)标题要避免孤立编号(即同级标题只有一个)。 示例:下面的文章结构, ## 二级标题 A### 三级标题 A## 二级标题 B (3)下级标题不重复上一级标题的名字。 示例:下面的文章结构,二级标题与下属的三级标题同名,建议避免。
(4)谨慎使用四级标题,尽量避免出现,保持层级的简单,防止出现过于复杂的章节。 如果三级标题下有并列性的内容,建议只使用项目列表(Item list)。 示例:下面的结构二要好于结构一。后者适用的场景,主要是较长篇幅的内容。 结构一### 三级标题#### 四级标题 A#### 四级标题 B#### 四级标题 C结构二### 三级标题**(1)A****(2)B****(3)C** 2.文本2.1字间距全角中文字符与半角英文字符之间,应有一个半角空格。
全角中文字符与半角阿拉伯数字之间,有没有半角空格都可,但必须保证风格统一,不能两种风格混杂。 正确:2011年5月15日,我订购了5台笔记本电脑与10台平板电脑。正确:2011 年 5 月 15 日,我订购了 5 台笔记本电脑与 10 台平板电脑。 半角的百分号,视同阿拉伯数字。 英文单位若不翻译,单位前的阿拉伯数字与单位间不留空格。
半角英文字符和半角阿拉伯数字,与全角标点符号之间不留空格。 错误:他的电脑是 MacBook Air 。正确:他的电脑是 MacBook Air。 2.2 句子
2.3写作风格1、尽量不使用被动语态,改为使用主动语态。
2、不使用非正式的语言风格。 错误:Lady Gaga 的演唱会真是酷毙了,从没看过这么给力的表演!!!正确:无法参加本次活动,我深感遗憾。 3、不使用冷僻、生造或者文言文的词语,而要使用现代汉语的常用表达方式。
4、用对“的”、“地”、“得”。 她露出了开心的笑容。(形容词+的+名词)她开心地笑了。(副词+地+动词)她笑得很开心。(动词+得+副词) 5、使用代词时(比如“其”、“该”、“此”、“这”等词),必须明确指代的内容,保证只有一个含义。
6、名词前不要使用过多的形容词。 错误:此设备的使用必须在接受过本公司举办的正式的设备培训的技师的指导下进行。正确:此设备必须在技师的指导下使用,且指导技师必须接受过由本公司举办的正式设备培训。 7、不包含任何标点符号的单个句子,或者以逗号分隔的句子构件,长度尽量保持在 20 个字以内;20~29 个字的句子,可以接受;30~39 个字的句子,语义必须明确,才能接受;多于 40 个字的句子,在任何情况下都不能接受。
8、同样一个意思,尽量使用肯定句表达,不使用否定句表达。 错误:请确认没有接通装置的电源。正确:请确认装置的电源已关闭。 9、避免使用双重否定句。
2.4英文处理英文原文如果使用了复数形式,翻译成中文时,应该将其还原为单数形式。 英文:⋯information stored in random access memory (RAMs)⋯中文:……存储在随机存取存储器(RAM)里的信息…… 外文缩写可以使用半角圆点(
表示中文时,英文省略号( 英文:5 minutes later⋯中文:5 分钟过去了⋯⋯ 英文书名或电影名改用中文表达时,双引号应改为书名号。
第一次出现英文词汇时,在括号中给出中文标注。此后再次出现时,直接使用英文缩写即可。 IOC(International Olympic Committee,国际奥林匹克委员会)。这样定义后,便可以直接使用“IOC”了。 专有名词中每个词第一个字母均应大写,非专有名词则不需要大写。
3.段落3.1原则
3.2引用引用第三方内容时,应注明出处。 One man’s constant is another man’s variable. — Alan Perlis 如果是全篇转载,请在全文开头显著位置注明作者和出处,并链接至原文。
使用外部图片时,必须在图片下方或文末标明来源。 本文部分图片来自 Wikipedia 4.数值4.1半角数字数字一律使用半角形式,不得使用全角形式。
4.2千分号数值为千位以上,应添加千分号(半角逗号)。 XXX 公司的实收资本为 RMB1,258,000。 对于 4 ~ 6 位的数值,千分号是选用的,比如 多位小数要从小数点后从左向右添加千分号,比如 4.3货币货币应为阿拉伯数字,并在数字前写出货币符号,或在数字后写出货币中文名称。
4.4数值范围表示数值范围时,用 带有单位或百分号时,两个数字都要加上单位或百分号,不能只加后面一个。 错误:132~234kg正确:132kg~234kg错误:67~89%正确:67%~89% 4.5变化程度的表示法数字的增加要使用“增加了”、“增加到”。“了”表示增量,“到”表示定量。
数字的减少要使用“降低了”、“降低到”。“了”表示增量,“到”表示定量。 降低到百分之八十(定额是一百,现在是八十)降低了百分之八十(原来是一百,现在是二十) 不能用“降低N倍”或“减少N倍”的表示法,要用“降低百分之几”或“减少百分之几”。因为减少(或降低)一倍表示数值原来为一百,现在等于零。 5.标点符号5.1原则
5.2句号中文语句中的结尾处应该用全角句号( 句子末尾用括号加注时,句号应在括号之外。
5.3逗号逗号 注意避免“一逗到底”,即整个段落除了结尾,全部停顿都使用逗号。 5.4顿号句子内部的并列词,应该用全角顿号( 错误:我最欣赏的科技公司有 Google, Facebook, 腾讯, 阿里和百度等。正确:我最欣赏的科技公司有 Google、Facebook、腾讯、阿里和百度等。 英文句子中,并列词语之间使用半角逗号(
5.5分号分号 5.6引号引用时,应该使用全角双引号( 例句:许多人都认为客户服务的核心是“友好”和“专业”。 引号里面还要用引号时,外面一层用双引号,里面一层用单引号(
5.7圆括号补充说明时,使用全角圆括号 例句:请确认所有的连接(电缆和接插件)均安装牢固。 5.8冒号全角冒号(
表示时间时,应使用半角冒号( 例句:早上 8:00 5.9省略号省略号 省略号不应与“等”这个词一起使用。
5.10感叹号应该使用平静的语气叙述,尽量避免使用感叹号 不得多个感叹号连用,比如 5.11破折号破折号 破折号应占两个汉字的位置。如果破折号本身只占一个汉字的位置,那么前后应该留出一个半角空格。 例句:直觉————尽管它并不总是可靠的————告诉我,这事可能出了些问题。例句:直觉 —— 尽管它并不总是可靠的 —— 告诉我,这事可能出了些问题。 5.12连接号连接号用于连接两个类似的词。 以下场合应该使用直线连接号(
以下场合应该使用波浪连接号(
例句:2009 年~2011 年 注意,波浪连接号前后两个值都应该加上单位。 波浪连接号也可以用汉字“至”代替。
6.文档体系6.1结构软件手册是一部完整的书,建议采用下面的结构。
下面是两个真实范例,可参考。 6.2文件名文档的文件名不得含有空格。 文件名必须使用半角字符,不得使用全角字符。这也意味着,中文不能用于文件名。 错误: 名词解释.md正确: glossary.md 文件名建议只使用小写字母,不使用大写字母。
为了醒目,某些说明文件的文件名,可以使用大写字母,比如 文件名包含多个单词时,单词之间建议使用半角的连词线( 不佳:advanced_usage.md正确:advanced-usage.md 7.参考链接
|
|
来自: 阿白mvo3hep7cv > 《Markdown》