程序员写作的必备技能 Markdown

2,815 阅读4分钟

作为一位程序员,除去 Coding 编程的硬技能之外,写作的软件能也是需要培养的,而写作处处离不开 Markdown,比如 GitHub 的 Readme 文档。

虽然 Markdown 的语法并不难,但是还是有很多技巧和规范的,我总结梳理了一下,分享给大家。

大神可以直接绕道了,这是给新手学习用的。

Markdown 是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。

为什么使用 Markdown?

为什么推崇 Markdown 写作? 而非 Word 类文档呢?

  • Markdown 是一段纯文本,使用任何文本编辑器都可以打开,而要打开 Word 文档,必须要先安装 Office 软件。
  • Markdown 可以很轻松的对文档进行排版,而使用 Word,排版要花费大量的精力。
  • Markdown 可以很轻松的转为 Html、Word、PDF 文件以及电子书。
  • 现有的大多数媒体平台都已支持 Markdown。
  • ……

Markdown 的创建的初衷实现「易读易写」,为的是可以让我们更专注于创作,从而提高写作效率。

有写作经验的朋友都应该很清楚,一篇文章如果要发送到多个媒体上,对于文章的排版是一件非常耗时的事情,而使用 Markdown 的文章排版只需一次即可。

如何使用 Markdown ?

Markdown 的优点说了这么多,它是否学起来很复杂呢?

其实 Markdown 是一个及其简单的语法,对于写作而言,我们在 5 - 10 分钟就可以轻松入门。

区块引用

引用标记符为>,通常用作标注文章的主旨,名人名言的引用等

这是一个引用

标题

形式则是在行首插入 1 到 6 个 #,对应的是 1 到 6 级标题

# 这是 H1

## 这是 H2

###### 这是 H6

列表

Markdown 支持有序列表和无序列表。

无序列表的标记是减号 -

- 无序列表1
- 无序列表2

等同于

  • 无序列表1
  • 无序列表2

有序列表则使用数字接着一个英文句点:

  1. 有序列表1
  2. 有序列表2
  3. 有序列表3

强调

两个 *_ 包起来即可, 特殊强调的文字段落都会被加粗。

这是一段强调的段落

*_ 两边不要有空格,否则它们就只会被当成普通的符号。

链接

只要使用方括号<>包起来, Markdown 就会自动把它转成链接。

baidu.com/

文字上的超链接是如何实现的呢?使用[链接名称](链接地址) 标记符号

[这是个百度的链接](http://baidu.com)

等同于

这是个百度的链接

图片

图片标记符号![图片名称](图片路径)

![简书](https://p1-jj.byteimg.com/tos-cn-i-t2oaga2asx/gold-user-assets/2017/11/30/1600d3b566694bdb~tplv-t2oaga2asx-image.image)

等同于

简书
简书

Markdown 插入的图片必须都是在线访问的, Markdown 中不能直接指定图片的高度和宽度。

特殊字符

如果我们在 Markdown 中要插入 >* 等等的特殊字符怎么办呢?在这些特殊字符前加上反斜杠/即可。

写作规范

掌握这么多语法就可以写作了吗?其实还是不够的,我们还需要掌握一些 Markdown 的写作规范。

中英文之间需要增加空格

正确:

CCTV 是央视频道。

错误:

CCTV是央视频道。

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

正确:

今年双十一我花费了 1000 元。

错误:

今年双十一我花费了1000元。

数字单位之间应该增加空格

正确:

这个硬盘是 10 TB。

错误:

这个硬盘是 10TB。

不要重复使用标点符号

正确:

今年双十一我居然花费了 1000 元!

错误:

今年双十一我居然花费了 1000 元!!??

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

正确:

请使用 WeChat 登录。

错误:

请使用 wechat 登录。

全角和半角符号

如果你不了解全角和半角符号,请查看全角百度百科

中文段落中使用中文全角标点。

正确:

嗨!你好!

错误:

嗨!你好!

英文整句使用半角标点

正确:

I Belive You.

错误:

I Belive You。

有研究表表明:打字时不喜欢在中英文之间加空格的人,感情路都会走的很辛苦!所以大家一定要养成写作规范的好习惯哦!

让我们一起愉快地使用 Markdown 开始创作吧!

参考文献