Markdown学习笔记

[toc]

导语

markdown是一种轻量级的标记语言,宜读宜写,常被用了写文章,记日记,总结经验,也被程序员用了写技术文档,技术博客。markdown的语法比较简单,常用的也就不超过10个,学习成本也比较低,一旦熟悉这种语法规则,有一劳永逸的效果,对以后的工作学习都有很好的帮助。简书、github、Tumblr等平台都原生支持markdown语法,学习markdown更有助于写出简洁美观宜与阅读的文章。

Markdown 官方文档

Markdown工具推荐

Mac Os X

  • MOU被很多人推荐

    Mou

  • Typora 有出Windows 和Linux版本的计划

    Typora

    Windows平台上

  • MarkdownEditorMetro风格的markdown编辑器,号称功能最全,一个亮点是与七牛存储集成,可以直接将本地图片上传到服务器,将图片的URL地址嵌入到编辑器

https://link.zhihu.com/?target=https%3A//www.microsoft.com/store/apps/9nblggh4q9rs
https://link.zhihu.com/?target=https%3A//www.microsoft.com/store/apps/9nblggh4q9rs
  • MarkdownPad一款全功能的编辑器,被很多人称赞为windows 平台最好用的markdown编辑器
MarkdownPad
  • MarkPad开源的 Markdown 编辑器,与 Window 8 风格和谐友好的界面,可以直接在你的博客或者 GitHub 中打开、保存文档,直接将图片粘贴到 Markdown 文档中。

MarkPad

web端

首推简书,简书是一个将写作与阅读整合在一起的网络产品。集合文字的书写、编集、发布功能于一体的在线写作编辑工具。

开源,免费,搭建在github page上,源码寄存在GitHub。整合Dropbox和Google Drive,自动同步(如果能够指定文件夹自动同步当然是最好的)支持一键发布到Google Blog,Tumblr等。可左右或者上下分栏,一边显示Markdown语言一边显示效果可以单击左右栏分界线切换至纯写作模式,同样可以收缩顶部工具栏。在网页顶部工具栏支持加粗、倾斜、超链接、撤消和还原 等等(注意:与Word处理方式有稍许不同)。不论在左栏还是右栏滚动页面另一侧也会同步。支持Markdown Extra 以GIst发布后支持分享(可以在线使用StackEdit阅读)多种保存格式详细的说明文档界面优美.

  • Markable.in,支持实时预览,自动保存,保存到Dropbox,发布到Tumblr等。

Markable.in
Markable.in

跨平台

  • Cmd Markdown 作业部落出品,也是一款不错的工具和博客平台兼顾的产品。全平台且提供web版

    Cmd Markdown

  • Haroopad是一款覆盖三大主流桌面系统的编辑器,支持 Windows、Mac OS X 和 Linux。 主题样式丰富,语法标亮支持 54 种编程语言。最新版支持流程图和幻灯片

    Haroopad

  • 小书匠编辑器 全平台覆盖并且有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

  • 图片链接

![](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.转义字符


\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号
&gt; >  
&amp; &
&brvbar; |
&nbsp; 空格(non-breaking space)

8.列表

  • 无序列表
    一个*或者+或者- 加上一个空格

    • 无序列表
    • 无序列表
    • 无序列表


  • 有序列表
    使用数字接着一个英文句点再加一个空格,数字可以任意值

    1. 第一项
    2. 第二项
    3. 第三项

9.段落和换行

单个回车视为空格.
连续回车才能分段

两种方式

  1. 输入<br/>

  2. 两个空格加回车键


一下是扩展语法

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]

参考文章:

  1. http://www.jianshu.com/p/4Q3aay
  2. http://www.cnblogs.com/gibbonnet/p/5373703.html
  3. https://www.zhihu.com/question/19637157
  4. http://zh.mweb.im/markdown-syntax-guide-suggest-version-zh.html#toc_24
  5. http://www.williamlong.info/archives/4319.html
  6. http://www.jianshu.com/p/1e402922ee32/
  7. Markdown 语法说明 (简体中文版)http://wowubuntu.com/markdown/#p

推荐阅读更多精彩内容

  • 为什么学习Markdown 自从搭建了 Hexo 博客之后,发现还有 Markdown 这种写文章的方法,想到以后...
    lifeColder阅读 15,438评论 12 214
  • Markdown 学习笔记·入门 花一点点时间了解了下Markdown的语法,确实非常简单,这里做下总结,也算是对...
    fantasykai阅读 142评论 0 0
  • Markdown简介 Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰...
    海浪浪里个浪阅读 55评论 0 0
  • 什么是Markdown Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,...
    北京光头阅读 77评论 0 2
  • 没想到这么快就会写第二篇,在第一篇写完之后的十五分钟内,我浏览了简书的设置方式,下载了安卓版,去换了套睡衣,还烧了...
    Seasong阅读 453评论 1 50