码迷,mamicode.com
首页 > 其他好文 > 详细

MarkDown写作技巧

时间:2016-08-21 21:10:08      阅读:181      评论:0      收藏:0      [点我收藏+]

标签:

# MarkDown写作技巧 #
年轻的我们往往苦恼于没有充实的社会经历、社会阅历,很难有较强的个人能力、个人魅力!就个人能力而言,无非分为两种:“吸收能力”和“输出能力”。吸收能力主要体现了个人对外界知识的摄入能力,主要包括:学习能力、阅读能力、听取能力、分析能力、理解能力等,这些能力可以帮助自己吸取理解进而加以分析自身的外界知识。与吸收能力相比,输出能力更是体现个人社会价值的一种能力了,其主要包括:概括能力、总结能力、表达能力、沟通能力、讲演能力和写作能力等。为了更好地表达与沟通,也许我们要做的更多的应该是分析、概括和总结了,然而,这个阶段写作能力往往是个人成长、社会分工中最重要的一种技能了。科学技术是第一生产力!本人却始终坚信:** 知识分享是科学技术的第一生产力!**

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

## 什么是MarkDown ##
Markdown到底是个啥?要解决这个what性质的问题,也许我们可以看看它的[官方网站][3]或者[维基百科](https://en.wikipedia.org/wiki/Markdown)上的阐述。其实,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. 我们会自动帮你添加数字
    7. 不用担心数字不对,显示的时候我们会自动把这行的 7 纠正为 3

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

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

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

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

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

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

---

注:更多细节可以查看 [Markdown 语法说明 (简体中文版)](http://wowubuntu.com/markdown/),或者 [github对Markdown的特征描述](https://guides.github.com/features/mastering-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://www.risame.net/sun/
[2]: https://bitbucket.org/Huiy/master-research/src/56b513d66dec?at=master
[3]: http://www.markdown.cn/
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>

MarkDown写作技巧

标签:

原文地址:http://www.cnblogs.com/huiyang865/p/5793517.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!