问小白 wenxiaobai
资讯
历史
科技
环境与自然
成长
游戏
财经
文学与艺术
美食
健康
家居
文化
情感
汽车
三农
军事
旅行
运动
教育
生活
星座命理

Markdown排版规范

创作时间:
作者:
@小白创作中心

Markdown排版规范

引用
1
来源
1.
https://www.cnblogs.com/PeterJXL/p/18332086

Markdown虽然简单易用,但要写出美观、规范的文档,还是需要遵循一些基本的排版规则。本文将从标题使用、强调语法、中英文字符间距以及中文标点符号等多个维度,为大家提供一份详细的Markdown排版指南。

Markdown 标记的使用规范

标题

  • 一级标题,通常是用来写文章的标题。而大部分情况下,文章的标题并不需要写在文章里,大多数博客有专门的位置填写标题,所以一级标题可以忽略。就好比一本书,书名就是一级标题,印在封面上,而书里就不用再写一级标题了。

  • 文章的内容则从二级标题开始使用,有小节的话就使用三级标题和四级标题。

  • 尽量少用五级标题和六级标题,避免层级过深,可以考虑用列表来替代。

强调语法

需要强调某处内容的时候可以用粗体。

中文排版中一般不用斜体,在英文排版中则可以用斜体表示书名、题目等。

引用语法通常用于:

  • 引述内容时(例如名人名言,也可直接用引号替代)

  • 作示例时

  • 给出提示、补充、警告等额外说明时

加个空格

接下来讲讲一个非常重要的规则:数字、英⽂字符和汉字连在⼀起时,中间要有⼀个空格。

为什么要加

下面进行一个对比测试:

  1. 在中文句子里,出现嵌入English Words的情况。

  2. 在中文句子里,出现嵌入“English Words”的情况。

  3. 在中文句子里,出现嵌入 English Words 的情况。

对于第一个句子,明显可以感觉英文字符是被挤压在句子中的。而后面两个句子因为英文字符前后有一定的空隙,则不会有这种感觉。其实,如果你不认真去感受,或者平时不去注意它,也就没有那么「碍眼」。

就好像那句经典的「研表究明,汉字序顺并不定一影阅响读。比如当你看完这句话后,才发这现里的字全是都乱的。」

据了解,Adobe 、Microsoft Office 等软件,以及 LaTex 等排版工具,都已经默认在汉字字符与西文字符之间增大间距,一般都是大约一个半角空格,这也就是我们日常写作、排版场景中感受不到这个问题的原因。

如何添加

最简单粗暴的方法:在写博客的时候手动添加空格。

此外,不少笔记软件支持自动添加空格,例如思源笔记就在文章页面有个优化排版的选项:

点击它,就可以为该文章自动添加空格。

使用第三方插件添加

如果你在网上冲浪时,看到其他网站都没有遵循这个规则,怎么办呢?可以使用浏览器插件,自动在网页中所有的中文字和半形的英文、数字、符号之间插入空白。

插件名:“為什麼你們就是不能加個空格呢?”

Chrome 安装地址:https://chrome.google.com/webstore/detail/paphcfdffjnbcgkokihcdjliihicmbpd

GitHub 开源地址:https://github.com/vinta/pangu.js

作者是这么说的:

如果你跟我一樣,每次看到網頁上的中文字和英文、數字、符號擠在一塊,就會坐立難安,忍不住想在它們之間加個空格。這個外掛(支援 Chrome 和 Firefox)正是你在網路世界走跳所需要的東西,它會自動替你在網頁中所有的中文字和半形的英文、數字、符號之間插入空白。

漢學家稱這個空白字元為「盤古之白」,因為它劈開了全形字和半形字之間的混沌。另有研究顯示,打字的時候不喜歡在中文和英文之間加空格的人,感情路都走得很辛苦,有七成的比例會在 34 歲的時候跟自己不愛的人結婚,而其餘三成的人最後只能把遺產留給自己的貓。畢竟愛情跟書寫都需要適時地留白。

與大家共勉之。

如果你是开发者,还可以通过 npm 的方式添加到你的网站,自动添加空格。

使用在线工具添加

网上有不少在线工具,可以自动优化排版(添加空格),例如zizhengwu.github.io/daft-auto-spacing:

最后

我之前没有这个加空格的习惯,在回看过去几年自己写过的技术文档,看到满篇粘连在一起的中英文字符,完全无法忍受,所以目前在逐篇优化排版(接近 1000 篇文章,是个大工程,得搞好久😐)。

中文标点符号规范

中文内容在排版时,应全文使用中文全角标点,无论内容中是否包含英文词语。

但如果中文内容包含了完整的英文句子或段落,那么英文内的标点使用半角标点。

引号:网络文章排版时使用直角引号——单引号「」,双引号『』。通常先使用「」。在引号嵌套引号时,才在内层用『』。直角引号在自媒体中比较常见,但有一些争议。

省略号:在中文输入法状态下,可使用快捷键

Shift + 6

输入省略号,注意是 6 个点,而非 3 个点。

破折号:在中文输入法状态下,可使用快捷键

Shift + -

输入破折号,注意该符号应占两个汉字宽度。

波浪线:在中文输入法状态下,可使用快捷键 Shift + ` (在 ESC 键下方) 输入波浪线。可用波浪线表示数值的区间,例如: 只要 10~20 分钟你便能掌握这篇文章的要领。

参考

会用 Markdown 还不够,还得知道排版规范

中西文混排时汉字与拉丁字母之间是否要有空格? - 知乎

推荐阅读

中文文案排版指北:https://github.com/sparanoid/chinese-copywriting-guidelines

© 2023 北京元石科技有限公司 ◎ 京公网安备 11010802042949号