Markdown for Typora使用手册

本文参考自Typora的官方手册

[TOC]

概览

之前一直想用Markdown来写东西,苦于找不到一个好用的Markdown编辑器,直到发现了Typora,用上之后就停不下来了。Typora是一个简洁优雅且免费的Markdown编辑器,它支持多平台(Mac/Windows/Linux),下载链接在这里。以下内容参考自Typora的官方手册,原文链接在这里

块元素

段落和换行

在Markdown源码中,段落之间需要用两个以上的空行分开,在Typora中,只需要一个空行(敲一下回车)来写新的段落。

标题

标题使用一个到六个(#)号放在一行的开头来定义,代表一级标题到六级标题。例如:

1
2
3
4
5
# 这是一级标题

## 这是二级标题

###### 这是六级标题

引用块

使用(>)号放在引用内容的开头来使用引用块,如果引用块跨多个段落,就在段落间的空行加上(>)例如:

1
2
3
> 这是包含了两个段落内容的引用块。 这是第一段。
>
> 这是第二段

效果:

这是包含了两个段落内容的引用块。 这是第一段。

这是第二段

若要使用内嵌引用块,则使用多个(>)号,如:

1
>> 这是一个套了两层的内嵌引用块

效果:

这是一个套了两层的内嵌引用块

列表

使用(*)/(+)/(-)来创建无序列表,例如:

1
2
3
*   Red
* Green
* Blue

效果:

  • Red
  • Green
  • Blue

使用(1.)来创建有序列表,例如:

1
2
3
1. Red
2. Green
3. Blue

效果:

  1. Red
  2. Green
  3. Blue

任务列表

使用(- [ ])或(- [x])创建任务列表,x代表默认勾选。例如:

1
2
3
4
- [x] 任务1
- [ ] 任务2
- [ ] 任务3
- [ ] 任务4

效果:

  • 任务1
  • 任务2
  • 任务3
  • 任务4

表格

在Typora中,输入| First Header | Second Header | 并按下回车,会创建一个包含两列的表格,点击表格可以使用表格的功能菜单直接对表格进行编辑。表格语法:

1
2
3
4
| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell | Content Cell |
| Content Cell | Content Cell |

效果:
| First Header | Second Header |
| ————- | ————- |
| Content Cell | Content Cell |
| Content Cell | Content Cell |

在列头加上冒号可以控制内容单元格的对齐方式,例如:

1
2
3
4
5
| Left-Aligned  | Center Aligned  | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is | some wordy text | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |

效果:
| Left-Aligned | Center Aligned | Right Aligned |
| :———— |:—————:| —–:|
| col 3 is | some wordy text | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |

除此之外,表格内容还支持加粗、斜体、超链接等语法。

注脚

可以像这样创建注脚:

1
[^注脚]:指解释字句的文字,也泛指解释、说明。

效果:

啥是^注脚

水平线

在一个空行后输入***---来生成一条水平线。
例如:

1
2

---

效果:


目录

输入[toc]按下回车,会根据标题自动创建目录

内联元素

超链接

使用[链接内容](链接地址 "标题")来创建超链接,例如:

1
这是一个[超链接](http://example.com/ "鼠标移至显示标题")的例子.

效果:
这是一个超链接的例子.

内部链接

Markdown支持创建指向文章标题的内部链接,例如:

1
这是一个内部链接的例子,Ctrl+鼠标左键点击[这里](#块元素)跳至`块元素`标题

效果:
这是一个内部链接的例子,Ctrl+鼠标左键点击这里跳至块元素标题

引用链接

若文章中多处用到同一个超链接,可以使用引用链接。使用两个中括号来创建,例如:

1
2
3
4
5
这是一个引用链接的[例子][id]。

然后在文章的任意位置为id赋值。

[id]: http://example.com/ "此处为标题,可空"

效果:

这是一个引用链接的例子

然后在文章的任意位置为id赋值。

若第二个中括号为空,则链接内容可以作为id使用,例如:

1
2
[百度][]
[百度]:https://www.baidu.com/

效果:
百度

URL

若内容是个URL地址,可以用<>来包裹,例如:

1
<i@typora.io>

效果:
i@typora.io

Typora会自动检测标准的URL地址,比如:www.baidu.com

图片

插入图片的语法为![文件名](文件路径),和超链接类似,需要在中括号前加个。例如:

1
2
3
![图片示例1](/path/to/img1.jpg)

![图片示例2](/path/to/img2.jpg "此处为标题,可空")

在Typora中,可以直接将图片拖入编辑器来插入图片。

若文章要发布到网上,那么肯定不能使用图片的本地路径。这时候就需要用到图床了,图床是指专门用来存放图片的服务器,可以用它来生成图片的永久外链。建议使用sm来生成,sm是一个在线生成图床的网站,支持多种图片格式,无需注册即可免费使用。使用图床生成图片链接后,将文件路径替换为链接即可,例如:

1
![typora](https://thumbsnap.com/i/iF31zInH.png?0221 "图片示例")

typora

斜体

使用(*)或(_)来包裹文本,可以将文本变成斜体。例如:

1
2
*使用星号渲染为斜体的文本*
_使用下划线渲染为斜体的文本_

效果:
使用星号渲染为斜体的文本
使用下划线渲染为斜体的文本

由于下划线经常用于变量的命名,GFM会忽略对这类斜体渲染。例如wow_great_stuff中的great并没有渲染成斜体。

若文本被*包裹,又不想显示斜体,可以在*前加上反斜杆\,例如:

1
\*被星号包裹的文本\*

效果:
*被星号包裹的文本*

Typora推荐使用星号(*)来渲染斜体。

粗体

使用双星号(**)或双下划线(__)来包裹文本,可以将文本变成粗体。例如:

1
2
3
**使用双星号渲染为粗体的文本**

__使用双下划线渲染为粗体的文本__

效果:
使用双星号渲染为粗体的文本

使用双下划线渲染为粗体的文本

Typora推荐使用双星号(**)来渲染粗体。

代码

行内代码使用倒引号(`)来包裹,例如:

1
这是一个`行内代码`

效果:
这是一个行内代码

代码块使用三个倒引号(```)来包裹。

删除线

GFM添加了删除线的语法,在标准的Markdown语法中是没有的。
使用双波浪线(~~)来为文本添加删除线,例如:

1
~~被删除的文本~~

效果:
被删除的文本

下划线

下划线使用原生的HTML代码来生成。例如:

1
<u>带下划线的文本</u>

效果:
带下划线的文本

表情符

输入表情符,可自动转换为表情,例如:

1
:smile:

效果:
:smile:

更多表情符,见这里

HTML

可以使用HTML语法来为内容添加样式,例如:

1
<span style="color:red">用HTML语法改变字体颜色为红色</span>

效果:
用HTML语法改变字体颜色为红色

但纯Markdown并不支持这种操作。

嵌入内容

有些网站提供了基于iframe的嵌入代码,可以直接拷贝至Typora。例如:

1
<iframe height='265' scrolling='no' title='Fancy Animated SVG Menu' src='http://codepen.io/jeangontijo/embed/OxVywj/?height=265&theme-id=0&default-tab=css,result&embed-version=2' frameborder='no' allowtransparency='true' allowfullscreen='true' style='width: 100%;'></iframe>

效果:

视频

使用HTML的<video>标签来嵌入视频,例如:

1
<video src="http://edge.ivideo.sina.com.cn/141968369.mp4?KID=sina,viask&Expires=1551024000&ssig=AcZJje8UOc" />

效果: