Markdown排版规范

news/2024/11/14 2:23:20/文章来源:https://www.cnblogs.com/PeterJXL/p/18332086

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

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.hqwc.cn/news/774001.html

如若内容造成侵权/违法违规/事实不符,请联系编程知识网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

便宜的和贵的 SSL 证书有什么区别?

在网络世界中,SSL 证书如同守护网站安全的忠诚卫士,确保数据在传输过程中的保密性和完整性。然而,当我们在选择 SSL 证书时会发现,其价格参差不齐,从免费到昂贵,跨度较大。那么,便宜的 SSL 证书和贵的 SSL 证书到底有哪些显著的区别呢? 验证级别和审核流程 首先,验证方…

在 Visual Studio 2022 中,开发 ASP.NET 网站并在 Windows Server 2003 中进行部署

一、ASP.NET 网站程序开发 新建项目类型:ASP.NET Web 应用程序(.NET Framework) 引用包:Microsoft.AspNet.WebApi、Microsoft.AspNet.Mvc,版本:4.0.X 创建文件:Global.asax 启动代码: public class WebApiApplication : HttpApplication {protected void Application_S…

stable diffusion 入门教程

sd基础 工作原理&入门输入提示词后 有文本编码器将提示词编译成特征向量,vae编码器将特征向量传入潜空间内,特征向量在潜空间内不断降噪,最后通过vae解码器将降噪之后的特征向量 解码成一个个像素组成的图片 一般选中默认vae模型解码编码的模型CLIP值越大,提前停止的越…

雷达气象学(5)——多普勒天气雷达的原理

目录5.1 多普勒效应和多普勒频移5.2 最大不模糊速度和速度模糊5.2.1 脉冲对处理技术5.2.2 最大不模糊速度5.2.3 速度模糊5.2.4 速度退模糊算法5.3 最大不模糊距离和距离折叠5.3.1 最大不模糊距离5.3.2 距离折叠5.3.3 距离去折叠的方法5.4 多普勒两难5.5 WSR-88D 的取样技术 5.1…

在macOS开发stm32:CubeIDE+CubePro方案

STM32CubeIDE和STM32CubeProgrammer都有Mac版。 STM32CubeIDE用于创建项目和编写代码,编译出HEX文件。 STM32CubeProgrammer用于连接ST-Link v2和烧录程序,把HEX文件下载到STM32单片机。 在安装STM32CubeIDE和STM32CubeProgrammer时,会把相关驱动下载安装。所以,等我安装完…

[HTTP] HTTP 协议 Response Header 之 Content-Length、Transfer-Encoding与Content-Encoding

0 引言在近期项目一场景中,一 Web API (响应内容:7MB - 40MB、数据项:5W-20W条)的网络传输耗时较大,短则 5s,长则高达25s,前端渲染又需要耗时 9s-60s。 在这个场景中,前端的问题暂且不表。那么针对后端的问题,个人认为还是有较大的优化空间:1)启用HTTP 内容压缩策略…

Zabbix 5.0 LTS 配置企业微信(Webhook)自动发送告警信息

依据前面文章《Zabbix 5.0 LTS URL 健康监测》环境,实现企业微信(Webhook)自动发送告警信息。 一、创建企业微信机器人先在自己的企业微信群里创建一个机器人,并获取其 WebHook 地址。右击群聊天卡片,添加群机器人。 获得一个类似下图的 WebHook 地址。注意,这个 WebHook 地…

【逆运动学2】damped least squares method阻尼最小二乘法

逆运动学逆运动学,就是从操作空间的end effector position and orientation,求关节空间的joint position的问题。在之前的文章,我们简单提到求逆运动学解的解析解法和优化解法,详细讲解了用逆瞬时(或说微分)运动学即雅可比矩阵法迭代求解逆运动学的方法。这篇文章我们继续…

CTFshow web入门vip 文件上传

CTFshow web入门vip 文件上传web151 题目提示前端校验不可靠,看源码可以看到是传到upload.php这个文件去接受文件上传,文件类型为图片,后缀限制为png 然后把前端验证修改一下,把文件后缀限制改成php 写个一句话木马传进去 1.php <?php eval($_POST[x]);?>url中需要…

我出一道面试题,看看你能拿 3k 还是 30k!

我会出一道经典的后端面试题,你只需要进行 4 个简单的选择,就能判断出来你的水平是新手(3k)、初级(10k)、中级(15k)还是高级(30k)!大家好,我是程序员鱼皮。欢迎屏幕前的各位来到今天的模拟面试现场,接下来我会出一道经典的后端面试题,你只需要进行 4 个简单的选择…

运维管理平台化:运维体系为什么要基于平台化建设

本文来自腾讯蓝鲸智云社区用户:CanWay摘要:笔者根据自身的技术和行业理解,分享嘉为蓝鲸数据与智能运维场景实践。 涉及关键字:一体化运维、平台化运维、数智化运维、AIOps、运维PaaS、运维工具系统、蓝鲸等。 本文作者:嘉为蓝鲸运维产品及解决方案负责人 张敏、嘉为蓝鲸平…