Typora Tutorial for Markdown

[TOC]

Markdown 是一种轻量级标记语言，创始人是约翰·格鲁伯（John Gruber）。它允许人们 “使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML 文档。

Typora是一款轻量级的Markdown 编辑器，重点在于所见即所得，与传统的两段显示不同，其极简的界面很受推崇。

这边简单介绍一下Typora上支持的markdown语法，因为这个博客markdown解析引擎的不同，有些语法不能很好的在博文里展现效果，感兴趣的话可以放到typora里尝试。

数学表达式

要启用这个功能，首先到Preference->Editor中启用。然后使用$符号包裹Tex命令，

例如： $lim_{x \to \infty} \ exp(-x)=0$ 将产生数学表达式：$lim_{x \to \infty} \ exp(-x)=0$

输入两个$符号，然后回车，就可以输入数学表达式块了。例如：

 $$\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} \mathbf{i} & \mathbf{j} &   \mathbf{k} \\\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0   \\\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\\end{vmatrix}$$ 

将会产生:

\[\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \\\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\\end{vmatrix}\]

关于更详细的LaTeX公式，可以参考这篇博客

下标

下标使用~包裹，例如：H~2~O将产生水的分子式。 eg. $H_2O$

上标

上标使用^包裹，例如：y^2^=4将产生表达式。 eg. $y^2=4$

插入表情

使用:happy:输入高兴的表情，使用:sad:输入悲伤的表情，使用:cry:输入哭的表情等。以此类推！

下划线

用HTML的语法<u>Underline</u>将产生下划线 Underline.

快捷键是Ctrl+U

删除线

GFM添加了删除文本的语法，这是标准的Markdown语法木有的。使用~~包裹的文本将会具有删除的样式，例如~删除文本~将产生~~删除文本~~的样式。

代码

使用`包裹的内容将会以代码样式显示，例如

使用`printf()`  

则会产生printf()样式。

输入~~~或者```然后回车，可以输入代码块，并且可以选择代码的语言。例如：

public Class HelloWorld{  
  System.out.println("Hello World!");  
}  

强调

使用两个*号或者两个_包裹的内容将会被强调。例如

**使用两个*号强调内容**
__使用两个下划线强调内容__

将会输出

使用两个*号强调内容 使用两个下划线强调内容 Typora 推荐使用两个*号。

斜体

在标准的Markdown语法中，*和_包裹的内容会是斜体显示，但是GFM下划线一般用来分隔人名和代码变量名，因此我们推荐是用星号来包裹斜体内容。如果要显示星号，则使用转义：

\*

eg. 这是斜体

插入图片

我们可以通过拖拉的方式，将本地文件夹中的图片或者网络上的图片插入。

插入URL链接

使用尖括号包裹的url将产生一个连接，例如：<www.baidu.com>将产生连接: .

如果是标准的url，则会自动产生连接，例如: 。

关于链接：英文输入下的中括号，里面填上你想写的话，然后在后面输入小括号里面贴上链接地址就可以了，它的快捷键是Ctrl+K 。

例如： [百度一下](www.baidu.com) 就可以变成百度一下

目录列表Table of Contents（TOC）

输入[toc]然后回车，将会产生一个目录，这个目录抽取了文章的所有标题，自动更新内容。

水平分割线

使用***或者---，然后回车，来产生水平分割线。

标注

我们可以对某一个词语进行标注。例如

某些人用过了才知道[^注释]  
[^注释]:Somebody that I used to know.

将产生：

某些人用过了才知道[^注释]

把鼠标放在注释上，将会有提示内容。

表格

|姓名|性别|毕业学校|工资|  
|:---|:---:|:---:|---:|  
|杨洋|男|重庆交通大学|3200|  
|峰哥|男|贵州大学|5000|  
|坑货|女|北京大学|2000|  

将产生:

姓名	性别	毕业学校	工资
杨洋	男	重庆交通大学	3200
峰哥	男	贵州大学	5000
坑货	女	北京大学	2000

其中代码的第二行指定对齐的方式，第一个是左对齐，第二个和第三个是居中，最后一个是右对齐。

事实上，通过右键–>insert的形式打开的，当然也可以通过快捷键Ctrl+T来打开。填入行数与列数就可以了。

任务列表

使用如下的代码创建任务列表，在[]中输入x表示完成，也可以通过点击选择完成或者没完成。

- [ ] 吃饭  
- [x] 逛街  
- [ ] 看电影  
- [ ] 约泡  

吃饭
逛街
看电影
约泡

列表

输入+, -, *,(+空格)创建无序的列表，使用任意数字开头，创建有序列表，例如：

**无序的列表**  
* tfboys  
* 杨洋  
* 我爱你  

无序的列表

tfboys
杨洋
我爱你

**有序的列表**  
苹果  
香蕉  
我都不喜欢  

有序的列表

苹果
香蕉
我都不喜欢

块引用

使用>来插入块引用。例如：

>这是一个块引用！  

将产生：

这是一个块引用！

标题

使用#表示一级标题，##表示二级标题，以此类推，有6个标题。

Diagrams

当前博客框架还没有 fully-support sequence, flowchart和Mermaid语法, 后续会逐步改进.

Sequence 时序图

由 js-sequence 驱动，可以在这里找到语法解释

```sequence
Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am good thanks!
```

Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am good thanks!

FlowChart 流程图

由 flowchart.js 驱动。

```flow
st=>start: Start
op=>operation: Your Operation
cond=>condition: Yes or No?
e=>end

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

st=>start: Start
op=>operation: Your Operation
cond=>condition: Yes or No?
e=>end

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

Mermaid

Typora也支持Mermaid语法，包括流程图，时序图和甘特图。

时序图

see this doc

```mermaid
%% Example of sequence diagram
  sequenceDiagram
    Alice->>Bob: Hello Bob, how are you?
    alt is sick
    Bob->>Alice: Not so good :(
    else is well
    Bob->>Alice: Feeling fresh like a daisy
    end
    opt Extra response
    Bob->>Alice: Thanks for asking
    end
```

%% Example of sequence diagram
  sequenceDiagram
    Alice->>Bob: Hello Bob, how are you?
    alt is sick
    Bob->>Alice: Not so good :(
    else is well
    Bob->>Alice: Feeling fresh like a daisy
    end
    opt Extra response
    Bob->>Alice: Thanks for asking
    end

流程图

see this doc

```mermaid
graph LR
A[Hard edge] -->B(Round edge)
    B --> C{Decision}
    C -->|One| D[Result one]
    C -->|Two| E[Result two]
```

graph LR
A[Hard edge] -->B(Round edge)
    B --> C{Decision}
    C -->|One| D[Result one]
    C -->|Two| E[Result two]

甘特图

see this doc

```mermaid
%% Example with selection of syntaxes
        gantt
        dateFormat  YYYY-MM-DD
        title Adding GANTT diagram functionality to mermaid

        section A section
        Completed task            :done,    des1, 2014-01-06,2014-01-08
        Active task               :active,  des2, 2014-01-09, 3d
        Future task               :         des3, after des2, 5d
        Future task2               :         des4, after des3, 5d

        section Critical tasks
        Completed task in the critical line :crit, done, 2014-01-06,24h
        Implement parser and jison          :crit, done, after des1, 2d
        Create tests for parser             :crit, active, 3d
        Future task in critical line        :crit, 5d
        Create tests for renderer           :2d
        Add to mermaid                      :1d

        section Documentation
        Describe gantt syntax               :active, a1, after des1, 3d
        Add gantt diagram to demo page      :after a1  , 20h
        Add another diagram to demo page    :doc1, after a1  , 48h

        section Last section
        Describe gantt syntax               :after doc1, 3d
        Add gantt diagram to demo page      : 20h
        Add another diagram to demo page    : 48h
```

%% Example with selection of syntaxes
        gantt
        dateFormat  YYYY-MM-DD
        title Adding GANTT diagram functionality to mermaid

        section A section
        Completed task            :done,    des1, 2014-01-06,2014-01-08
        Active task               :active,  des2, 2014-01-09, 3d
        Future task               :         des3, after des2, 5d
        Future task2               :         des4, after des3, 5d

        section Critical tasks
        Completed task in the critical line :crit, done, 2014-01-06,24h
        Implement parser and jison          :crit, done, after des1, 2d
        Create tests for parser             :crit, active, 3d
        Future task in critical line        :crit, 5d
        Create tests for renderer           :2d
        Add to mermaid                      :1d

        section Documentation
        Describe gantt syntax               :active, a1, after des1, 3d
        Add gantt diagram to demo page      :after a1  , 20h
        Add another diagram to demo page    :doc1, after a1  , 48h

        section Last section
        Describe gantt syntax               :after doc1, 3d
        Add gantt diagram to demo page      : 20h
        Add another diagram to demo page    : 48h

常用快捷键

加粗：Ctrl+B

斜体：Ctrl+I

字体：Ctrl+数字

下划线：Ctrl+U

返回开头：Ctrl+Home

返回结尾：Ctrl+End

生成表格：Ctrl+T

创建链接：Ctrl+K

Typora for Markdown

Markdown on Typora tutorial

Typora Tutorial for Markdown

数学表达式

下标

上标

插入表情

下划线

删除线

代码

强调

斜体

插入图片

插入URL链接

目录列表Table of Contents（TOC）

水平分割线

标注

表格

任务列表

列表

块引用

标题

Diagrams

Sequence 时序图

FlowChart 流程图

Mermaid

时序图

流程图

甘特图

常用快捷键

CATALOG

FEATURED TAGS

FRIENDS