Markdown写作注意事项

Markdown 作为一种标识语言,在很多地方都有用到,自己一般做笔记也会使用 Markdown,方便又快捷。自己使用 Markdown 也有一段时间了,这里整理一些关于 Markdown 写作的资源,和建议。


01 Markdown 语法

Markdown 语法比较简单,这里推荐 Github 上的一篇文章。这边文章比较简练,而且比较全,初学者阅读这一偏文章就可以了。无需在浪费时间看各种各样的学习资料。
Markdown 语法简介 : https://github.com/younghz/Markdown

注意事项

  • Markdown语法主要分为如下几大部分: 标题段落区块引用代码区块强调列表分割线链接图片反斜杠 \符号 ‘`’
  • 特殊字符显示有问题,可以通过转义字符表示 eg: \* 会避免 * 同后面的 * 将中间文件变为斜体
  • 空格缩进表示,推荐使全角符号下的 空格  解决缩进和空格表示。
  • 普通用户不用去学习额外的扩展的语法,比如画流程图,各种图,各种复杂的东西,专业的事情交给专业的软件去做。
  • 强制换行,可以在末尾加上两个英文空格在回车表示换行,但是我自己习惯在末尾加上 <br /> 来表示强制换行。
  • 在文件中输出空行。有三种方式可以输出空行,两个换行,或者一个空行 和 <br />,但是这快不属于基本统一的语法,需要根据编辑的具体环境自己选择使用。

02 编辑工具

在这里推荐三款编辑工具:

  • Typora 五颗星,强烈推荐。别是对于非程序员而言,这一款就够了,不用在花力气找别的编辑器了。而且这款软件是跨平台的, Windows Linux Max 系统都支持。使用时注意:
  • 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
  • 比较长的文章加上目录是不错的习惯
  • 正确的大小写真的可以显得专业
  • 中文中的直角引号确实比引号好看很多 『单引号』 「双引号」
  • 总的来说,还是 空格中文标点符号 的处理。
发布了5 篇原创文章 · 获赞 5 · 访问量 1771

猜你喜欢

转载自blog.csdn.net/qq_38591886/article/details/105018314