Markdown 作为一种标识语言,在很多地方都有用到,自己一般做笔记也会使用 Markdown,方便又快捷。自己使用 Markdown 也有一段时间了,这里整理一些关于 Markdown 写作的资源,和建议。
01 Markdown 语法
Markdown 语法比较简单,这里推荐 Github 上的一篇文章。这边文章比较简练,而且比较全,初学者阅读这一偏文章就可以了。无需在浪费时间看各种各样的学习资料。
Markdown 语法简介 : https://github.com/younghz/Markdown
注意事项:
- Markdown语法主要分为如下几大部分: 标题,段落,区块引用,代码区块,强调,列表,分割线,链接,图片,反斜杠
\
,符号 ‘`’。 - 特殊字符显示有问题,可以通过转义字符表示 eg:
\*
会避免 * 同后面的 * 将中间文件变为斜体 - 空格缩进表示,推荐使全角符号下的 空格 解决缩进和空格表示。
- 普通用户不用去学习额外的扩展的语法,比如画流程图,各种图,各种复杂的东西,专业的事情交给专业的软件去做。
- 强制换行,可以在末尾加上两个英文空格在回车表示换行,但是我自己习惯在末尾加上
<br />
来表示强制换行。 - 在文件中输出空行。有三种方式可以输出空行,两个换行,或者一个空行 和
<br />
,但是这快不属于基本统一的语法,需要根据编辑的具体环境自己选择使用。
02 编辑工具
在这里推荐三款编辑工具:
- Typora 五颗星,强烈推荐。别是对于非程序员而言,这一款就够了,不用在花力气找别的编辑器了。而且这款软件是跨平台的, Windows Linux Max 系统都支持。使用时注意:
- 学习一些快捷功能 Typora 快捷键大全 文档未完成
- 学会使用一款图床工具,将图片放在网络上,可以保证文章在任何地方只要联网就可以观看 Typora 图床使用 文档未完成
- 下载一些主题,可以选择自己喜欢的风格 Typora 主题安装 文档未完成
- 转出 PDF 方便发给别人
- Vim 五颗星,强烈推荐。如果你是程序员,恰巧也使用 Vim 作为开发工具,那么选择 Vim 作为 Markdown 编辑工具没错了。注意事项:
- vim 不能随时渲染 Markdown 文件,需要安装一些插件 Vim Markdown 插件支持 未完成
- 如果你懂 HTML 语法的话,也可以将一些简单的 HTML 语法插入 Markdown 文件中,这样可以写出更丰富的格式。
- 将一些常用的 HTML 格式,制作成代码片段,效率会提高很多。
- VS Code 也是一款优秀的编辑文本,本人用的很少,没有太多经验,只是看到很多人都在推荐,而且现在用的人越来越多。如果你使用 VS Code 作为开发工具,可以参考下面这篇文章配置 VS Code。
用VS Code打造最佳Markdown编辑器
03 文本规范
在开始使用 Markdown 语法写作一段时间后,就开始思考如何使得写作结果更加美观。在这里推荐一份比较中肯的写作建议。
Markdown 写作规范 : https://github.com/sparanoid/chinese-copywriting-guidelines/blob/master/README.zh-CN.md
基本按照这篇文章的规范就可以写出很漂亮的文本了。当然自己爱好是最重要的,最终还是按照自己审美爱好来编辑就可以了。
重点强调
- 中英文之间加空格,习惯了真的挺好 Markdown
- 比较长的文章加上目录是不错的习惯
- 正确的大小写真的可以显得专业
- 中文中的直角引号确实比引号好看很多 『单引号』 「双引号」
- 总的来说,还是 空格 和 中文标点符号 的处理。