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

引用

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

图片

跟链接的方法区别在于前面加了个感叹号 ‘!’,这样是不是觉得好记多了呢? 例:![图片名称](http://图片网址)

换行

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

分隔符

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

公式

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

符号转义

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


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

MarkDown优势

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

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

MarkDown写作工具

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

在线编辑器

浏览器插件

  • MaDe (Chrome)

语言包

编辑器/IDE插件

参考链接

  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
posted @ 2016-08-21 20:32  数据之风  阅读(1907)  评论(0编辑  收藏  举报