Markdown文档编写规则:标点符号
本文转载自阮一峰的 Github。
原则
- 中文语句的标点符号,均应该采取全角符号,这样可以保证视觉的一致。
- 如果整句为英文,则该句使用英文/半角标点。
- 句号、问号、叹号、逗号、顿号、分号和冒号不得出现在一行之首。
句号
中文语句中的结尾处应该用全角句号(。
)。
句子末尾用括号加注时,句号应在括号之外。
错误:关于文件的输出,请参照第 1.3 节(见第 26 页。)正确:关于文件的输出,请参照第 1.3 节(见第 26 页)。
逗号
逗号,
表示句子内部的一般性停顿。
注意避免“一逗到底”,即整个段落除了结尾,全部停顿都使用逗号。
顿号
句子内部的并列词,应该用全角顿号(、
) 分隔,而不用逗号,即使并列词是英语也是如此。
错误:我最欣赏的科技公司有 Google, Facebook, 腾讯, 阿里和百度等。正确:我最欣赏的科技公司有 Google、Facebook、腾讯、阿里和百度等。
英文句子中,并列词语之间使用半角逗号(,
)分隔。
例句:Microsoft Office includes Word, Excel, PowerPoint, Outlook and other components.
分号
分号;
表示复句内部并列分句之间的停顿。
引号
引用时,应该使用全角双引号(“ ”
),注意前后双引号不同。
例句:许多人都认为客户服务的核心是“友好”和“专业”。
引号里面还要用引号时,外面一层用双引号,里面一层用单引号(‘ ’
),注意前后单引号不同。
例句:鲍勃解释道:“我要放音乐,可萨利说,‘不行!’。”
圆括号
补充说明时,使用全角圆括号()
,括号前后不加空格。
例句:请确认所有的连接(电缆和接插件)均安装牢固。
冒号
全角冒号(:
)常用在需要解释的词语后边,引出解释和说明。
例句:请确认以下几项内容:时间、地点、活动名称,以及来宾数量。
表示时间时,应使用半角冒号(:
)。
例句:早上 8:00
省略号
省略号……
表示语句未完、或者语气的不连续。它占两个汉字空间、包含六个省略点,不要使用。。。
或...
等非标准形式。
省略号不应与“等”这个词一起使用。
错误:我们为会餐准备了香蕉、苹果、梨…等各色水果。正确:我们为会餐准备了各色水果,有香蕉、苹果、梨……正确:我们为会餐准备了香蕉、苹果、梨等各色水果。
感叹号
应该使用平静的语气叙述,尽量避免使用感叹号!
。
不得多个感叹号连用,比如!!
和!!!
。
破折号
破折号————
一般用于进一步解释。
破折号应占两个汉字的位置。如果破折号本身只占一个汉字的位置,那么前后应该留出一个半角空格。
例句:直觉————尽管它并不总是可靠的————告诉我,这事可能出了些问题。例句:直觉 —— 尽管它并不总是可靠的 —— 告诉我,这事可能出了些问题。
连接号
连接号用于连接两个类似的词。
以下场合应该使用直线连接号(-
),占一个半角字符的位置。
- 两个名词的复合
- 图表编号
例句:氧化-还原反应例句:图 1-1
以下场合应该使用波浪连接号(~
),占一个全角字符的位置。
- 数值范围(例如日期、时间或数字)
例句:2009 年~2011 年
注意,波浪连接号前后两个值都应该加上单位。
波浪连接号也可以用汉字“至”代替。
例句:周围温度:-20°C 至 -10°C
Markdown文档编写规则:标点符号相关推荐
- 语雀 | markdown文档编写常用快捷键
这里写目录标题 一.标题 二.序号 2.1 有序列表 2.2 无序列表 三.其他 3.1 代码 3.2 插入链接 3.3 引用 3.4 待办 3.5 分割线 一.标题 一级标题 # + 空格键 二级标 ...
- 关于Typora编辑器编写markdown文档时插入出现前字吞后字的解决方法
关于Typora编辑器编写markdown文档时插入出现前字吞后字的解决方法 原因是按到了键盘上的Insert键,使得编辑模式变为了改写,所以会把文本替换掉,这个按键没有状态标示.
- php编写文件管理工具,php之markdown文档管理工具的实现代码
本文主要和大家分享php之markdown文档管理工具的实现代码,希望能帮助到大家. 主要目标: 1.可以多人编辑 2.可以在浏览器中查看 3.有一个可以折叠的目录 4.支持多级目录 5.支持mark ...
- 关于Typora编辑器编写markdown文档的代码块出现前字吞后字的解决方法
关于Typora编辑器编写markdown文档的代码块出现前字吞后字的解决方法 最近使用Typora编辑器编写markdown文档的代码块出现前字吞后字的情况,结果我在网上并未搜到什么解决方法(或者并 ...
- 程序设计文档编写_编写有效的设计系统文档的6个技巧
程序设计文档编写 重点 (Top highlight) I wrote this article to document what I'm learning professionally while ...
- api 开源文档编写_如何为您的开源项目编写有效的文档
api 开源文档编写 不幸的是,好的代码并不能说明一切. 即使是解决世界上最紧迫问题的设计最精美,编写最出色的代码库,也不会自己采用. 开源创建者您需要为您的代码说话,并为您的创作注入生命. 那就是技 ...
- 【编程规范】 后端API接口设计编写与文档编写参考
文章目录 0 统一规范 0.1 理清业务流程 0.2 定义前后端开发的接口规范 0.3 定义接口文档 1 后端接口编写 1.0 后端接口介绍 1.0.1 接口交互 1.0.2 返回格式 1.0.3 C ...
- 【效率工具】markdown文档自动同步到印象笔记evernote
本地markdown文档同步印象笔记 在本地使用 MarkdownPad.Mark.Typora.VSCode 任意你喜欢的 Markdown 编辑器进行文档编写,本工具将自动同步文档到印象笔记.可以 ...
- markdown文档管理工具
介绍 电脑中存了很多markdown文档,为了管理这些文档,特写了这个md管理工具. 我的想法是,把现有的markdown文件复制到指定文件夹中,自动生成markdown的网页,不仅可以在自己电脑上运 ...
最新文章
- RPA和AI:加速数字化转型的步伐
- Oracle对象之序列
- Linux怎么处理binray文件,Linux下如何反汇编arm raw binary文件
- Qt文档阅读笔记-单元测试中构建标准检测程序(CPU、Linux性能、内存泄漏等)
- NSCT(Nonsubsampled Contourlet变换)
- java 实现敏感词汇的过滤
- [创业]赢在中国,马云点评创业,经典
- Linux那些事儿 之 戏说USB(21)向左走,向右走
- Java I/O---概述
- 【嵌入式流媒体开发】Linux ALSA 声卡数据采集与播放
- 百度智能云落子贵阳,工业互联网进入新赛段
- win10 ST-GCN复现
- 华为路由器相同网段DHCPv6配置
- IP和MNC地址协议
- MCtalk创业声音丨博学明辨:兴趣社交,给退休前后老年朋友的「小而美」空间
- 2022-2028年中国金融业OCR识别行业市场调查研究及前瞻分析报告
- VoIP通话之SIP协议
- java replica set_K8s 的ReplicaController ReplicaSet DaemonSet和Job
- 中国落石防护网市场十四五规划及未来发展趋势报告2022-2028年
- 怎么把图片弄成logo_ps怎样把logo图案添加在照片上?
热门文章
- 国内十大无代码平台,无代码app开发平台有哪些?
- 关于JavaScript精确度问题
- C++:实现量化OptionletStripper测试实例
- GreenDao3.2数据库使用教程
- php程序把图片变成漫画,用AI把真人照片变矢量漫画风格
- memoQ电子书 | 聚焦视频翻译技术
- linux dc命令,Linux中ntpdc命令起什么作用呢?
- 《从0到1》读书笔记第8章“秘密”第1记: 浪潮之巅
- “一言”槽点满满 “千帆”下海收费
- c/c++ 结束进程的方法