MarkDown写作技巧

前言

年轻的我们往往苦恼于没有充实的社会经历、社会阅历，很难有较强的个人能力、个人魅力！就个人能力而言，本 人主要把它分为两种：“吸收能力”和“输出能力”。吸收能力主要体现了个人对外界知识的摄入能力，主要包括：学习能力、阅读能力、听取能力、分析能力、理 解能力等，这些能力可以帮助自己吸取理解进而加以分析自身的外界知识。与吸收能力相比，输出能力更是体现个人社会价值的一种能力了，其主要包括：概括能 力、总结能力、表达能力、沟通能力、讲演能力和写作能力等。为了更好地表达与沟通，也许我们要做的更多的应该是分析、概括和总结了，然而，这个阶段写作能 力往往是个人成长、社会分工中最重要的一种技能了。科学技术是第一生产力！本人却始终坚信： 知识分享是科学技术的第一生产力！(技术小白对’能力’这个概念不太全面的体悟，希望大家多指点，共同勉励、共同进步！)

谈到写作，人们可能更青睐于word或者LaTeX等等写作工具(特别是写论文大牛的科学研究者)。本人在读研期间也多次跟着我的导师(孙小兵老师)一起用LaTeX写过几篇英文文章(点击这里), 深深体会到LaTeX排版论文的便利。然而，对于一些规范性要求不算太高的博客文章，LaTeX自然是不适合的，网络上大部分的免费博客的在线编辑系统不 免也让人会有些抓狂。作为技术宅+博客作者的我们，也许Markdown是另一个更佳的写作工具了。下面让我们来初探一下Markdown：

什么是MarkDown

Markdown到底是个啥？要解决这个what性质的问题，也许我们可以看看它的官方网站或者维基百科上 的阐述。其实，Markdown是一个易读易写的网络文本书写工具。它可以很好地支持github,Stackoverflow等各大开源网站，此外，为 了方便地将文本内容转化成HTML格式，Markdown形成了自己的一套语法，其语法目标：成为一种适用于网络的书写语言。总之，Markdown 的目标是实现「易读易写」。

MarkDown语法

代码

对 于一个技术宅，Markdown对代码编排的支持及其使用的便利性是非常重要的，Markdown支持的语言很多：actionscript, apache, bash, clojure, cmake, coffeescript, cpp, cs, css, d, delphi, django, erlang, go, haskell, html, http, ini, java, javascript, json, lisp, lua, markdown, matlab, nginx, objectivec, perl, php, python, r, ruby, scala, smalltalk, sql, tex, vbscript, xml.

下面是本人例举python代码的编排结果：

def g(x):
    yield from range(x, 0, -1)
yield from range(x)

注意事项：编排python代码时，需要在代码与文字之间隔一行且在代码之前至少保持4个空格缩进。

标题

文章内容较多时需要使用标题分段，Markdown支持两种标题标记方式：

1. 在标题下方添加下添加多个’=’或者多个’-‘来表达标题的不同等级；
2. 在标题左右添加’#’，根据’#’数量不同区分标题等级。 例：#标题1# ##标题2##

斜粗体

Markdown使用’‘表示字体的斜体或者粗体，当文字左右添加一个’‘时表示斜体，两个’‘表示粗体，三个’‘表示斜粗体。 例：*斜体* **粗体** ***粗斜体***

链接

常用的链接主要有文字链接和网址链接：

• 文字链接，用’[]’将要链接的文字括起来，后面的链接用’()’将括起来紧接其后； 例：[要链接的文字](网址)
• 网址链接，用’<>’将网址括起来即可。 例：\<网址>

列表

• 普通无序列表，在文字前面用’+,-,*‘等符号，并在符号与文字之间空格一格；例：

  - 列表文本前使用 [减号+空格]
  + 列表文本前使用 [加号+空格]
  * 列表文本前使用 [星号+空格]

• 普通有序列表，在文字前面添加’1. ‘等数字和’.’号，并在其后加一个空格。例：

  1. 列表前使用 [数字+空格]
  2. 我们会自动帮你添加数字
  3. 不用担心数字不对，显示的时候我们会自动把这行的 7 纠正为 3

引用

引用前使用’>’+空格，每行前都要添加哦。例：
> 引用文本前使用 [大于号+空格]
> 折行可以不加，新起一行都要加上哦

图片

跟链接的方法区别在于前面加了个感叹号 ‘!’，这样是不是觉得好记多了呢？ 例：

换行

如果是另起一行，只需要在结尾加两个空格，如果是另起一个段落，只需要空一行就行了。

分隔符

如果你有写分割线的习惯，可以新起一行输入三个减号’-‘。当前后都有段落时，请空出一行。

公式

当你需要在编辑器中插入数学公式时，可以使用两个美元符 ‘$$’ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后，问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。

符号转义

如果你的描述中需要用到 markdown 的符号，比如 ‘# *‘ 等，但又不想它被转义，这时候可以在这些符号前加反斜杠，如 \# \* 进行避免。

---

注：更多细节可以查看 Markdown 语法说明 (简体中文版)，或者 github对Markdown的特征描述。

MarkDown优势

根据调查，本人总结了Markdown猪油有如下优势：

• 纯文本，所以兼容性极强，可以用所有文本编辑器打开。
• 让你专注于文字而不是排版。
• 格式转换方便，Markdown 的文本你可以轻松转换为 html、电子书等。
• Markdown 的标记语法有极好的可读性。

MarkDown写作工具

一切就这么简单。Markdown之所以越来越流行,是因为它足够简单。试试吧～

在线编辑器

• http://dillinger.io/
• http://markable.in/editor/
• http://anwensf.com/edit

浏览器插件

• MaDe (Chrome)

语言包

• python语言包Markdown: https://pypi.python.org/pypi/Markdown

编辑器/IDE插件

• Atom插件
  1. markdown-writer https://atom.io/packages/markdown-writer
  2. markdown-preview https://atom.io/packages/markdown-preview
• pycharm插件
  在pycharm中创建一个’.md’为后缀的文件，pycharm会自动下载安装对应的插件。

参考链接

1. http://wowubuntu.com/markdown/
2. https://zh.wikipedia.org/wiki/Markdown
3. http://www.jianshu.com/p/q81RER
4. http://markdown.tw
5. https://www.zybuluo.com/mdeditor
6. https://www.zhihu.com/question/20409634
7. http://www.markdown.cn/
8. http://sspai.com/markdown-guide
9. https://segmentfault.com/markdown
10. https://guides.github.com/features/mastering-markdown/
11. https://atom.io/packages/markdown-writer
12. https://atom.io/packages/markdown-writer
13. https://pypi.python.org/pypi/Markdown
14. http://www.markdowntutorial.com/
15. http://anwensf.com/markdown