看了简书的 为什么作家应该用 Markdown 保存自己的文稿 后,改用Markdown,但简书的Markdown好像暂不支持 公式 和 流程图!
关于Markdown
Markdown 是一种轻量级标记语言。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。
参考文件
Markdown语法
首行缩进
#一个空格
 
#两个空格
 
#不断行空白格
栗子:
- 一个空格;
- 两个空格;
- 不断行空白格;
段落与换行
- 段落的前后必须是空行
空行是指行内什么都没有,或者只有空白符(空格或制表符)
相邻两行文本,如果中间没有空行,会显示在一行中(换行符被转换为空格) - 如果需要在段内加入换行
可以在前一行的末尾加入至少两个空格,然后换行写其它的文字 - 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
- 有序列表2
- 有序列表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
表格
- 不管是哪种方式,第一行为表头,第二行为分割表头和主体部分,第三行开始每一行为一个表格行;
- 列与列之间用管道符号 | 隔开;
- 第二行还可以为不同的列指定对其方向,默认左对齐,在 - 右边加上 : 就右对齐
代码:
学号 | 姓名 | 分数
- | - | -
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公式
是一种跨平台的基于TEX的排版系统,对于生成复杂表格和数学公式,这一点表现得尤为突出。
因此它非常适用于生成高印刷质量的科技和数学、化学类文档。
MathJax是一种跨浏览器JavaScript库,它使用MathML,LaTeX和ASCIIMathML 标记在Web浏览器中显示数学符号。
MathJax作为Apache License下的开源软件。
语法
$
表示行内公式
质能守恒公式 $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
网友评论