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##
斜粗体
Markdown使用’‘表示字体的斜体或者粗体,当文字左右添加一个’‘时表示斜体,两个’‘表示粗体,三个’‘表示斜粗体。 例:*斜体* **粗体** ***粗斜体***
链接
常用的链接主要有文字链接和网址链接:
- 文字链接,用’[]’将要链接的文字括起来,后面的链接用’()’将括起来紧接其后; 例:[要链接的文字](网址)
- 网址链接,用’<>’将网址括起来即可。 例:\<网址>
列表
-
普通无序列表,在文字前面用’+,-,*‘等符号,并在符号与文字之间空格一格;例:
- 列表文本前使用 [减号+空格]
+ 列表文本前使用 [加号+空格]
* 列表文本前使用 [星号+空格] -
普通有序列表,在文字前面添加’1. ‘等数字和’.’号,并在其后加一个空格。例:
- 列表前使用 [数字+空格]
- 我们会自动帮你添加数字
- 不用担心数字不对,显示的时候我们会自动把这行的 7 纠正为 3
引用
引用前使用’>’+空格,每行前都要添加哦。例:
> 引用文本前使用 [大于号+空格]
> 折行可以不加,新起一行都要加上哦
图片
跟链接的方法区别在于前面加了个感叹号 ‘!’,这样是不是觉得好记多了呢? 例:![图片名称](http://图片网址)
换行
如果是另起一行,只需要在结尾加两个空格,如果是另起一个段落,只需要空一行就行了。
分隔符
如果你有写分割线的习惯,可以新起一行输入三个减号’-‘。当前后都有段落时,请空出一行。
公式
当你需要在编辑器中插入数学公式时,可以使用两个美元符 ‘$$’ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。
符号转义
如果你的描述中需要用到 markdown 的符号,比如 ‘# *‘ 等,但又不想它被转义,这时候可以在这些符号前加反斜杠,如 \# \* 进行避免。
注:更多细节可以查看 Markdown 语法说明 (简体中文版),或者 github对Markdown的特征描述。
MarkDown优势
根据调查,本人总结了Markdown猪油有如下优势:
- 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
- 让你专注于文字而不是排版。
- 格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
- Markdown 的标记语法有极好的可读性。
MarkDown写作工具
一切就这么简单。Markdown之所以越来越流行,是因为它足够简单。试试吧~
在线编辑器
浏览器插件
- MaDe (Chrome)
语言包
- python语言包Markdown: https://pypi.python.org/pypi/Markdown
编辑器/IDE插件
- Atom插件
- markdown-writer https://atom.io/packages/markdown-writer
- markdown-preview https://atom.io/packages/markdown-preview
- pycharm插件
在pycharm中创建一个’.md’为后缀的文件,pycharm会自动下载安装对应的插件。
参考链接
- http://wowubuntu.com/markdown/
- https://zh.wikipedia.org/wiki/Markdown
- http://www.jianshu.com/p/q81RER
- http://markdown.tw
- https://www.zybuluo.com/mdeditor
- https://www.zhihu.com/question/20409634
- http://www.markdown.cn/
- http://sspai.com/markdown-guide
- https://segmentfault.com/markdown
- https://guides.github.com/features/mastering-markdown/
- https://atom.io/packages/markdown-writer
- https://atom.io/packages/markdown-writer
- https://pypi.python.org/pypi/Markdown
- http://www.markdowntutorial.com/
- http://anwensf.com/markdown