Markdown语法

看了简书的 为什么作家应该用 Markdown 保存自己的文稿 后,改用Markdown,但简书的Markdown好像暂不支持 公式 和 流程图!



关于Markdown

Markdown 是一种轻量级标记语言。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。

参考文件

Markdown-wiki
Markdown官网
Markdown中文文档
Markdown语法


Markdown语法

首行缩进

#一个空格
  

#两个空格
 

#不断行空白格
 

栗子:

  1.  一个空格;
  2.  两个空格;
  3.  不断行空白格;


段落与换行

  • 段落的前后必须是空行
    空行是指行内什么都没有,或者只有空白符(空格或制表符)
    相邻两行文本,如果中间没有空行,会显示在一行中(换行符被转换为空格)
  • 如果需要在段内加入换行

    可以在前一行的末尾加入至少两个空格,然后换行写其它的文字
  • Markdown中的多数区块都需要在两个空行之间


粗体和斜体

语法:

*斜体*, _斜体_
**粗体**
***粗斜体***
~~删除线~~

显示效果:

  • 斜体, 斜体
  • 粗体
  • 粗斜体
  • 删除线


分级标题

Setext形式

大标题:

一级大标题
========

二级大标题
--------

效果:

一级大标题

二级大标题

atx形式

普通标题:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题

显示效果

一级标题

二级标题

三级标题


超链接

MarkDown支持两种形式的链接语法:行内式和参考式。

行内式

语法说明:
[ ] 里面写链接文字,( ) 里面写链接地址,()中的" "可以指定title属性。

代码:
欢迎来到 [简书](www.jianshu.com "Jianshu")
效果:
欢迎来到 简书

参考式

参考式超链接一般用在学术论文上面,或某一个链接在文章中多处使用,那么引用的方式创建链接将非常好,它可以让你对链接进行统一的管理。
语法说明:

参考式链接分为两部分,文中的写法[链接文字][链接标记],在文本任意位置添加[链接标记]:链接地址 “链接标题”,链接地址与链接标题前有一个空格
如果链接文字本身可以作为链接标记,也可以写成[链接文字][]
[链接文字]:链接地址的形式

代码:

简书里面有 [简书早报][1]、[简书晚报][2]以及 [简黛玉][3]
[简黛玉 美人][3] 是一个[才女][]
[1]:http://www.jianshu.com "Jianshu"
[2]:http://www.jianshu.com "EveningPaper"
[3]:http://www.jianshu.com
[才女]:http://www.jianshu.com

效果:

简书里面有 简书早报简书晚报以及简黛玉
简黛玉 美人 是一个才女

自动链接

MarkDown支持以比较简短的自动链接形式来处理网址和电子邮件,只要用<>包起来,MarkDown就会自动把它转成链接。
代码:

<http://example.com>
<address@example.com>

显示效果:
http://example.com
address@example.com


锚点

网页中,锚点其实就是网页内超链接,也就是链接本文档内部的某些元素,实现当前页面中的跳转。比如返回顶部
注意:

MarkDown Extra只支持在标题后插入锚点,其他地方无效;
Leanote编辑器右侧显示效果区域暂时不支持锚点跳转,所以点来点去发现没有跳转不必惊慌,你发布后的文章是支持的;
在你准备跳转到的指定标题后插入锚点{#标记},然后在其他地方写上连接到锚点的链接

代码:

目录{#index}
跳转到 [目录](#index)

效果:
目录{#index}
跳转到 目录


列表

无序列表

使用 * ,+ ,- 表示无序列表
代码:

- 无序列表1
- 无序列表2
- 无序列表3

效果:

  • 无序列表1
  • 无序列表2
  • 无序列表3

有序列表

有序列表使用数字接着英文点
代码:

1. 有序列表1
2. 有序列表2
3. 有序列表3

效果:

  1. 有序列表1
  2. 有序列表2
  3. 有序列表3

定义型列表

定义型列表由名词和解释组成。一行写上定义,紧跟一行写上解释。解释的写法:紧跟一个缩进(Tab)
代码:

MarkDown
:    轻量级文本标记语言,可以转换成html、pdf等格式(注意一个冒号和一个Tab)

代码块 2
:    这是代码块的定义

        代码块(左侧有八个空格)

列表缩进

列表项目标记通常是放在最左边,但是其实也可以缩进,最多3个空格,项目标记后则一定要接着至少一个空格或制表符。
代码:

*    轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
*    那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。

效果:

  • 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
    那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
  • 那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。


引用

引用需要在被引用的文本前加上 > 符号
代码:

> 引用1
> 引用2

效果:

引用1
引用2

引用的多层嵌套

区块引用可以嵌套(如引用的引用),只要根据层次加上不同数量的 >符号
代码:

>>> 请问MarkDown怎么用?
>> 自己看教程!
> 教程在哪里?

效果:

请问MarkDown怎么用?

自己看教程!

教程在哪里?


插入图像

图片的创建方式与超链接类似。
代码:
[图片上传失败...(image-8a94bb-1512008355179)]


内容目录

在段落中填写 [TOC] 以显示全文内容结构目录


注脚

在需要添加注脚的文字后加上注脚名字 [^注脚名字],称为加注。然后在文中的任意位置(一般最后)添加脚注,脚注前必须有对应的脚注名字。
注脚与注脚间必须空一行!
注脚自动被搬运到最后面,请到文章末尾查看,并且脚注后的链接可以直接跳转会到加注的地方
代码:

使用 MarkDown[^1]可以提高书写效率,直接转换成 HTML[^2]
[^1]:MarkDown是一种纯文本标记语言
[^2]:HTML超文本标记语言

效果:
使用 MarkDown[1]可以提高书写效率,直接转换成 HTML[2]

分割线

可以在一行中用 三个以上的 *,-,_ 建立一个分割线,行内不能有其他东西。
** 代码: **

1. * * * *
2.
3. ****
4.
5. - - - -
6.
7. --------

效果:








扩展语法

Markdown标准 本身所包含的功能有限,所以产生了许多第三方扩展语法,如 GFW, GitHub Flavored Markdown

Tasklist

代码:

- [ ] Monday
- [ ] Tuesday
- [ ] Wednesday
- [ ] Tuesday
- [ ] Friday

效果:

  • [ ] Monday
  • [ ] Tuesday
  • [ ] Wednesday
  • [ ] Tuesday
  • [ ] Friday


表格

  1. 不管是哪种方式,第一行为表头,第二行为分割表头和主体部分,第三行开始每一行为一个表格行;
  2. 列与列之间用管道符号 | 隔开;
  3. 第二行还可以为不同的列指定对其方向,默认左对齐,在 - 右边加上 : 就右对齐

代码:

学号 | 姓名 | 分数
- | - | -
001 | 张三 | 78
002 | 李四 | 67
003 | 王五 | 99
学号 姓名 分数
001 张三 78
002 李四 67
003 王五 99


代码块和高亮

代码块

插入代码的方式有两种,一种是利用缩进(Tab),另一种是利用反引号 `` 和 ``` ```
代码:

Python语言的输出函数 `Print()` 怎么使用?

效果:
Python语言的输出函数 Print() 怎么使用?

import os
from flask import Flask
app = Flask(app)

高亮

在 ``` 之后添加代码的语言
代码:
```python
import os
from flask import Flask
app = Flask(app)
```

效果:

import os
from flask import Flask
app = Flask(app)


流程图

** 流程图语法参考 **


LaTeX公式

关于LaTEX:

是一种跨平台的基于TEX的排版系统,对于生成复杂表格和数学公式,这一点表现得尤为突出。
因此它非常适用于生成高印刷质量的科技和数学、化学类文档。

关于MathJax:

MathJax是一种跨浏览器JavaScript库,它使用MathML,LaTeX和ASCIIMathML 标记在Web浏览器中显示数学符号。
MathJax作为Apache License下的开源软件。

MathJax语法


语法

$表示行内公式
质能守恒公式 $E=mc^2$ 方程式
效果:$E=mc^2$

$$表示整行公式
代码:

$$\sum_{i=1}^n a_i=0$$

$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$

$$\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}$$

效果:
$$\sum_{i=1}^n a_i=0$$

$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$

$$\sum^{j-1}{k=0}{\widehat{\gamma}{kj} z_k}$$


Markdown编辑器

介绍一些常用的书写、编辑Markdown的工具。

  • MarkdownPad Windows (windows)
  • Texts (Windows, osX)
  • MarkPad (Windows)
  • Haroopad (Windows, osX, Linux)
  • ReText (Linux)
  • 等等;

格式转换

Markdown文档可以方便地转换为 HTML, Word, PDF 等文件格式。
可以利用 软件 或者 命令 转换文件。

转换为 HTML

转换为 PDF

转换为 Word





  1. MarkDown是一种纯文本标记语言

  2. HTML超文本标记语言

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,684评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,143评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,214评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,788评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,796评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,665评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,027评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,679评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,346评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,664评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,766评论 1 331
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,412评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,015评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,974评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,073评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,501评论 2 343