[toc]
导语
markdown是一种轻量级的标记语言,宜读宜写,常被用了写文章,记日记,总结经验,也被程序员用了写技术文档,技术博客。markdown的语法比较简单,常用的也就不超过10个,学习成本也比较低,一旦熟悉这种语法规则,有一劳永逸的效果,对以后的工作学习都有很好的帮助。简书、github、Tumblr等平台都原生支持markdown语法,学习markdown更有助于写出简洁美观宜与阅读的文章。
Markdown 官方文档
Markdown工具推荐
Mac Os X
-
MOU被很多人推荐
-
Typora 有出Windows 和Linux版本的计划
Windows平台上 MarkdownEditorMetro风格的markdown编辑器,号称功能最全,一个亮点是与七牛存储集成,可以直接将本地图片上传到服务器,将图片的URL地址嵌入到编辑器
- MarkdownPad一款全功能的编辑器,被很多人称赞为windows 平台最好用的markdown编辑器
- MarkPad开源的 Markdown 编辑器,与 Window 8 风格和谐友好的界面,可以直接在你的博客或者 GitHub 中打开、保存文档,直接将图片粘贴到 Markdown 文档中。
web端
首推简书,简书是一个将写作与阅读整合在一起的网络产品。集合文字的书写、编集、发布功能于一体的在线写作编辑工具。
- StackEdit好用的网页版编辑器
开源,免费,搭建在github page上,源码寄存在GitHub。整合Dropbox和Google Drive,自动同步(如果能够指定文件夹自动同步当然是最好的)支持一键发布到Google Blog,Tumblr等。可左右或者上下分栏,一边显示Markdown语言一边显示效果可以单击左右栏分界线切换至纯写作模式,同样可以收缩顶部工具栏。在网页顶部工具栏支持加粗、倾斜、超链接、撤消和还原 等等(注意:与Word处理方式有稍许不同)。不论在左栏还是右栏滚动页面另一侧也会同步。支持Markdown Extra 以GIst发布后支持分享(可以在线使用StackEdit阅读)多种保存格式详细的说明文档界面优美.
- Markable.in,支持实时预览,自动保存,保存到Dropbox,发布到Tumblr等。
跨平台
-
Cmd Markdown 作业部落出品,也是一款不错的工具和博客平台兼顾的产品。全平台且提供web版
-
Haroopad是一款覆盖三大主流桌面系统的编辑器,支持 Windows、Mac OS X 和 Linux。 主题样式丰富,语法标亮支持 54 种编程语言。最新版支持流程图和幻灯片
-
小书匠编辑器 全平台覆盖并且有web版
文库集成类
GitBook: 集成GitHub
Madoko: 集成GitHub, DropBox, OneDrive
马克飞象: 集成印象笔记
GitBook的火热程度如同GitHub,我所看到的很多软件帮助文档、技术教程,都已经在GibBook上发布。GitBook于2014年创办,已发布35500本书籍。
图床
Markdown作为纯文本格式,自然不能粘贴图像文件,只能嵌入图像的地址(URL或者本地地址)。所以插入图片需要预先将图片存储在网络。
在chrome搜图床就会出现这三个,都挺好用的。
另外一个图床墙裂推荐七牛,七牛是云服务提供商,注册就送10G云存储
如何使用看这篇文章http://www.jianshu.com/p/5f0d5451ca01
配合MPic,一款支持拖曳、复制、截图上传的七牛图床神器,用起来爽爆了。
截屏工具
windows平台Faststone Capture
体积小巧、功能强大。不但具有常规截图等功能,更有从扫描器获取图像,和将图像转换为 PDF 文档等功能,该软件拥有不规则抓图、滚动抓图、活动窗口抓图、图片简单处理、屏幕录制等很多很多实用的功能。
Mac OS X平台 Snip<br />
Snip是一款腾讯推出的一款截图工具,是Mac平台的截屏应用,支持自动识别窗口、图标标记再次编辑、关联QQ邮箱截屏、滚动截屏、邮件分享截图、支持Retina显示屏等。
语法
1. 标题
行首用1-6个#开头表示不同级别的标题
2. 引用
行首使用 > 加上一个空格表示引用一个段落,可嵌套
3. 分割线
在一行连续三个或者三个以上_或者*
___
***
途中分割线不是很明显。
4.代码区域
代码区域内的文字不会被处理,按照原样输出。
每一行前边加入4个空格或者一个tab可以标记一个代码段落:
int main(){
return 0
}
效果如下
还可以使用 `这是代码块` 来标记行内代码
如:在activity的初始化代码一般是` protected void onCreate(Bundle savedInstanceState){super.onCreate(savedInstanceState);}`
效果如下
也可以用三个`表示代码块
javascript var a = "hello world"; var b = "good luck";
5.强调
*斜体*
**粗体**
_斜体_
__粗体__
6. 链接
Markdown有两种链接方式:Inline以及Reference
-
文字链接
Inline:
谷歌
Reference:
[谷歌][google_url]
[google_url]:https://www.google.com
- 图片链接
![](https://www.baidu.com/img/bd_logo1.png)
![][baidu_logo]
[baidu_logo]:https://www.baidu.com/img/bd_logo1.png
注意!第二种叹号后第一个[]容易漏掉,一定不要忘记哦。
当图片url地址含有(或)时的处理
![](http://upload-images.jianshu.io/upload_images/952850-a13e32e16c607e19.latex?imageMogr2/auto-orient/strip))
![][latex_img]
[latex_img]:http://latex.codecogs.com/gif.latex?%5Cprod(n_%7Bi%7D+100)
![](http://latex.codecogs.com/gif.latex?\prod(n_{i_1})+10000)
- 自动链接
使用尖括号<>包含住一段地址或者邮箱
http://www.baidu.com
7.转义字符
\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号
> >
& &
¦ |
 ; 空格(non-breaking space)
8.列表
-
无序列表
一个*或者+或者- 加上一个空格- 无序列表
- 无序列表
-
无序列表
-
有序列表
使用数字接着一个英文句点再加一个空格,数字可以任意值- 第一项
- 第二项
- 第三项
9.段落和换行
单个回车视为空格.
连续回车才能分段
两种方式
输入
<br/>
两个空格加回车键
一下是扩展语法
10.任务列表
未做任务- + 空格 + [ ]
已做任务- + 空格 + [x]
- [ ] 任务一 给女朋友买口红
- [x] 任务二 陪女朋友吃饭
11.表格格式
第一格表头 | 第二格表头
--------- | -------------
内容单元格 第一列第一格 | 内容单元格第二列第一格
内容单元格 第一列第二格 多加文字 | 内容单元格第二列第二格
12.删除线
加删除线像这样用: ~~删除这些~~
13.顺序图或流程图
```sequence
张三->李四: 嘿,小四儿, 写博客了没?
Note right of 李四: 李四愣了一下,说:
李四-->张三: 忙得吐血,哪有时间写。
```
```flow
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认?
st->op->cond
cond(yes)->e
cond(no)->op
```
14.MathJax
关于MathJax与LaTex
可参考该文章
块级公式:
$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$
\\[ \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} =
1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}
{1+\frac{e^{-8\pi}} {1+\ldots} } } } \\]
行内公式: $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$
15.脚注(Footnote)
第一[^1x]
[^1x]:脚注的用发
百度地址[^百度地址]
[^百度地址]:www.baidu.com
在文档的末尾自动生成如下图所示脚注
16.TOC
如果想点击文章中某一小标题自动滚动到标题位置,如何做呢,很简单。
[toc]
参考文章:
- http://www.jianshu.com/p/4Q3aay
- http://www.cnblogs.com/gibbonnet/p/5373703.html
- https://www.zhihu.com/question/19637157
- http://zh.mweb.im/markdown-syntax-guide-suggest-version-zh.html#toc_24
- http://www.williamlong.info/archives/4319.html
- http://www.jianshu.com/p/1e402922ee32/
- Markdown 语法说明 (简体中文版)http://wowubuntu.com/markdown/#p