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)

插入图片

图片链接

![图片链接](https://i-blog.csdnimg.cn/blog_migrate/ad89fc32f52efe69c25bc1d6ee431374.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/

转载于:https://www.cnblogs.com/xuwei09/p/7292020.html

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值