/document-guide

中文博客的排版指南。

中文博客排版指南

标题

正确:(Markdown 语法)

# 文章的标题

## 文章内容的一级标题

### 文章内容的二级标题

#### 文章内容的三级标题

原则:

(1)文章内容的标题一般用 #####。为保证层级的简单,请尽量避免出现 #### 的标题。

(2)为保证标题的连贯性,# 的标题下不要直接出现 ### 的标题。

图片

1、图片大小

为方便网络传输,且保证清晰度,图片大小尽量控制在 100 KB500 KB 之间。

如果图片过大,可以使用网址 https://tinypng.com/ 进行压缩;如果图片不够清晰,请重新制图。

2、图片格式

静态图片用 png、jpg 格式。

动态图用 gif 格式。gif 动图可以使用软件 LICEcap 录制屏幕生成。

gif 图的帧数不要超过 300 帧,否则无法上传到公众号。一般情况下,gif 图的大小控制在 500kb 以内,基本能符合要求。

3、图片文件名

图片的文件名使用当前时间戳,格式:YYMMDD_HHMM。格式举例:

20190902_1010.png

20180228_1505.jpg

20180616_1618.gif

4、截图工具

5、流程图制作工具

6、图片素材网站

Unsplash 是国外知名度最高的免费高清网站(图片素材免费、无版权),是现代年轻人喜欢的 ins 简约风,到处都充满生活剪影。

免费正版高清图片素材库。

Markdown 规范

1、换行

每两段的中间,需要空出一行。

正确:

段落1(这里是第一行)

段落2(这里其实是第三行)

错误:

段落1(这里是第一行)
段落2(这里是第二行)

2、四级标题

文中的四级标题,请不要用 ####,建议使用加粗文本即可。

正确:

**我是四级标题**:

错误:(四级标题渲染出来的字体大小,其实跟普通文本差不多,所以不要用)

#### 我是四级标题

空格

中英文之间需要增加空格

正确:

任何可以使用 JavaScript 来编写的应用,最终都会由 JavaScript 编写。

错误:

任何可以使用JavaScript来编写的应用,最终都会由JavaScript编写。

中文和数字之间需要增加空格

正确:

一年有 12 个月。

错误:

一年有12个月。

数字和单位之间需要加空格

正确:

正确:一部容量为 16 GB 的智能手机

错误:

错误:一部容量为 16GB 的智能手机

完整的英文整句时标点与单词之间需要加空格

正确:

Stay hungry, stay foolish. That is Steve's famous quote.

错误:

Stay hungry,stay foolish.That is Steve's famous quote.

例外:度的标志、百分号不加空格

正确:

今天气温有 35° 的高温。

据统计,关注 GitHub 的读者中有 80% 是码农。

例外:全角标点与其他字符之间不加空格

正确:

全球最大的同性交友社区 GitHub,已被微软收购。

专有名词使用正确的大小写

正确:

想要学习 Web 前端,应该首先学习 HTML、CSS、JavaScript、jQuery、Ajax、Vue.js、React 等基础内容。

错误:

想要学习 web 前端,应该首先学习 html、css、Javascript、Jquery、ajax、vue.js、react 等基础内容。

正确:

GitHub、Android、iOS、iPhone 6s、iPhone SE、MacBook Pro

标点

关于全角和半角

简单来说,全角占两个字节,半角占一个字节。你可以理解成中文汉字和中文标点是全角,英文字母和英文标点是半角。体现在排版上的差异就是,全角字符屏幕打印宽度是两个,而半角字符屏幕打印宽度是一个,如中文逗号和英文逗号他们的显示分别是「,」和「,」。

更详细的介绍,可以查看维基百科的词条「全角和半角

使用全角中文标点

中文排版中,所有的标点都应该使用全角中文标点。

示例:

大家好,我正在使用 GitHub。

遇到英文整句、特殊名词时使用半角标点

示例:

乔布斯说过:「Stay hungry, stay foolish.」

Facebook, Inc.

需要特别强调的词,建议用直角引号

示例:

互联网上充斥着大量的内容,「知识付费」成为下一个风口。我每天使用「得到」App,阅读一小时。

图床工具

写文章免不了要做图片传图片,推荐使用 PicGo 工具,不论屏幕截图、还是复制图片,都可以自动上传、保存 Markdown 格式的链接,直接粘贴插入。

对了,在使用 PicGo 之前,先要保证你要有一个保存图片的图床服务器,配置到 PicGo 上,然后再让 PicGo 帮你生成图片的 url 链接。

公众号 Markdown 编辑器推荐

市面上常见的、大众的、小众的、在线版的 Mardown 排版工具,都在这儿了。

大部分排版工具,可以针对外链,自动生成脚注。

可能吧排版

Rabbit Hole微信排版编辑器

无广告、沉浸式写作、支持定制化主题、审美在线、一键复制后即可发布 的排版编辑器。免登陆+免费使用。

详细介绍:Juicing 工具篇——「Rabbit Hole」微信排版编辑器上线Juicing Juice 导论 | 一份榨汁机说明书

Markdown 在线编辑器

lab.lyric.im排版

歌词经理作品。

zkqiang.cn排版

aclickall.com排版

openwrite 排版

mdnice 排版

这个 markdown 排版网站用的人挺多,在程序员的圈子流传很广。但自2020年10月底开始,需要登录才能使用;它已经不再单纯是一个排版工具了,逐渐向社区演进,略显臃肿。

文本纠错

写作猫(文本纠错网站):https://xiezuocat.com/

参考链接