Fork me on GitHub

5分钟快速入门Markdown(一)

Table of Contents generated with DocToc

前言

一直比较羡慕有些博主博客排版精致,比如文章的索引,引用块和代码块的样式等,当然还有一些开源代码库中readme中排版的样式也特别精致。只知道有Markdown这么个东西,因为太懒从来都没有好好看看Markdown的语法。最近打算整理下自己项目中的Readme说明,就大概看了下MarkDown的语法,粗略的看了一遍后深深的被她吸引,记录下来以供参考。

markdown基础语法

强调

着重强调

**着重强调**

斜体

*斜体*

换行

在行尾输入两个或以上的空格,然后回车

引用

这句话是引用的,看看,自动加上引用样式了
这行还是引用

这个是嵌套引用
这个还是第二层嵌套

这个是第三层嵌套

继续第一层嵌套

引用只需要在被引用的内容段落开头加上右尖括号('>')即可。你可以选择只在开头加一个。也可以在每行前面都加一个,效果是一样的。
多个>表示嵌套引用(如>>,>>>)
需要一个视觉上的空行表示嵌套的结束
例:
>这句话是引用的,看看,自动加上引用样式了  
这行还是引用
>>这个是嵌套引用
这个还是第二层嵌套  

>>>这个是第三层嵌套  

>继续第一层嵌套  

分级标题

分别表示不同的标题分级
 #,##,###,####,#####,######,#######
也可以用
这是一级标题
======
这是二级标题
------

列表

  • 列表1
  • 列表2
  • 列表3
  • 列表1
  • 列表2
  • 列表3
  1. 列表1
  2. 列表2
  3. 列表三
无序可以用*,+,-作为列表标记,有序列表可以用1. (数字+英文句点+空格)标记

超链接

惠租车

[惠租车](https://www.huizuche.com)

插入图片

图片链接

![图片链接](http://cdn.qiniu.hzc.huizuche.com/idl/idl-big.png)

插入引用标注

Markdown语法[1]

引用处:
 [^mark] 
 如:Markdown语法[^mark] 
引用说明处:
如:
[^mark]:这是一个引用标注[维基百科Markdown](https://zh.wikipedia.org/wiki/Markdown)

插入文章目录

在线博客基本都不支持TOC生成目录,可以通过https://github.com/thlorenz/doctoc 生成目录,非常好用

文章任何需要插入目录的地方
[TOC]

水平分区线


以下每一种写法都产生一条水平分区线
* * *
***
*****
- - -
---------------------------------------

代码段

function GetData(){
  $.ajax(url).success(function(data){
    console.log(data);
  }).error(function(s,s,d){
    console.log(d);
  })
}

```javascript function GetData(){ $.ajax(url).success(function(data){ console.log(data); }).error(function(s,s,d){ console.log(d); }) }```

Markdown高级语法

表格

Item 标题1 标题二
左对齐 右对齐 中间对齐
|Item       |标题1     |标题二    |
|:----------|--------:|:-------:|
|左对齐      |    右对齐|   中间对齐|
|左         |        右|        中|

数学公式[2]

  部分博客中不直接支持数学公式
  公式中常见的字母
$$\alpha  
 A \beta B \gamma \Gamma \delta \Delta \epsilon E \varepsilon  \zeta Z \eta H \theta \Theta \vartheta \iota I \kappa K \lambda \Lambda \mu M \nu N \xi \Xi o O \pi \Pi \varpi  \rho P \varrho  \sigma \Sigma \varsigma  \tau T \upsilon \Upsilon \phi \Phi \varphi  \chi X \psi \Psi \omega \Omega$$
**行内公式**:$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$
**块级公式**:$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

流程图

在线博客基本不支持

st=>start: 开始  
e=>end: 结束    
op=>operation: 操作 
cond=>condition: 是否满足条件? 

st->op->cond
cond(yes)->e
cond(no))->op
st=>start: 开始  
e=>end: 结束    
op=>operation: 操作   
cond=>condition: 是否满足条件?  

st->op->cond
cond(yes)->e
cond(no))->op

时序图

在线博客基本不支持

Client->Server: request
Note right of Server: 服务端响应
Server-->Client: response  
```sequence
Client->Server: request
Note right of Server: 服务端响应
Server-->Client: response
```占位符

Markdown相关软件

专为印象笔记(Evernote)打造的Markdown编辑器https://maxiang.io/
作为在线的Markdown编辑器,GitHub,博客园,简书 都有支持
在线博客基本都不支持TOC生成目录,可以通过https://github.com/thlorenz/doctoc 生成目录,非常好用

结语

以上都是我看完语法后,自己一个个敲出来的,就当是以后的备用手册了,后面一边使用一边再完善吧。


  1. 这是一个引用标注维基百科Markdown ↩︎

  2. 数学公式参照http://oiltang.com/2014/05/04/markdown-and-mathjax/ ↩︎

posted @ 2017-08-06 01:42  紫雨夜  阅读(306)  评论(0编辑  收藏  举报
快速评论