目录

本文地址：https://www.cnblogs.com/deeround/p/14831776.html
Git地址：https://github.com/deeround/WriteMarkdownUsingTypora

Typora

介绍

Typora是一款功能全面、简洁高效，而且又非常优雅的Markdown编辑器。它把源码编辑和效果预览合二为一，在输入标记之后随即生成预览效果，提供了“所见即所得”的Markdown写作体验。

Typora是目前最受欢迎的Markdown编辑器之一。它的主要特性如下。
1）实时预览：传统的Markdown编辑器都有两个窗口，左边是源码，右边是渲染后的效果。Typora独辟蹊径，把源码编辑和效果预览合二为一，实现了真正的所见即所得。
2）扩展语法：Typora不光支持GFM，还扩展了数学公式、流程图等功能。
3）快捷操作：Typora对几乎所有的Markdown标记都提供了快捷操作方式，使用起来非常高效。
4）界面漂亮：默认支持6种主题，可自定义，好看又好用。
5）文件转换：支持多种文件格式通过导入/导出功能跟.md格式相互转换。
6）支持中文：支持中文，可以帮助大家更好地理解各项功能。
7）视图模式：支持大纲和文档列表视图，方便在不同段落和不同文件之间进行切换。
8）跨平台：支持macOS、Windows和Linux系统。
9）目前免费：这么好用的编辑器竟然是免费的。

使用

1.下载安装

下载地址：https://typora.io/#download。

2.设置语言

在默认情况下，Typora会使用操作系统的语言，如果想要自定义语言，可以在Typora编辑器上执行如下操作：【偏好设置】→【通用】→【语言】，选择语言后，重启Typora即可生效。

3.其他偏好设置推荐

【文件】→【偏好设置】→【外观】→【侧边栏】勾选侧边栏的大纲视图允许折叠和展开

【文件】→【偏好设置】→【编辑器】→【默认换行符】选择LF

【文件】→【偏好设置】→【图像】→【插入图片时】选择复制图片到./${filename}.assets 文件夹和勾选对本地位置的图片应用上述规则和勾选优先使用相对路径

【文件】→【偏好设置】→【Markdown】→【Markdown扩展语法】全部勾选；【空格与换行】勾选显示<br/>和选择忽略连续的空格与单个换行

4.主题

Typora提供了5款漂亮的主题供大家选择，每一个都很漂亮。可通过菜单栏上的【主题】进行切换，默认是Github主题。主题也可以根据自己喜欢进行自定义。

Typora实际上也是一个浏览器，每一个主题就是一个css文件，如果想自定义主题，可直接修改该css文件。

【文件】→【偏好设置】→【外观】→【主题】打开主题文件夹就能看到所有主题对应的css文件。

比如要修改Github主题，该主题对应的css文件就是github.css，不建议直接修改原来的css文件，而是创建名为github.user.css进行编写自定义样式，该样式文件Typora也会自动加载。

github.user.css（）

/*自定义样式*/
/*修改了引用标签的样式*/
blockquote{border-left: 4px solid #62ca38!important;background:#f8f8f8!important;padding:10px!important;}

5.空格与换行

官方说明：https://support.typora.io/Line-Break/

在Markdown中，换行符非常令人困惑，Typora的官方建议是：

  • 使用Typora的默认设置。
  • 用Typora的混合视图编写。
  • 按下Enter键插入新的段落，并避免插入新行。
  • 如果您确实需要一个单独的换行符，请使用以下语法：<br/>。

空格

连续空格类似于单行换行符，大多数Markdown引擎都会忽略它们。

默认情况下，Typora将在编辑视图中保留连续的空格，并在打印或导出时将其忽略。您可以在首选项面板中更改此选项。

如果您确实想插入其他Markdpwn引擎支持的连续空格，则可以

  • 转义空格，\在每个空格之前输入
  • 使用HTML实体 &nbsp;。

换行

Markdown提供了插入单个强行换行符的方法：

  • 插入两个空格和一个换行符。
  • <br/>直接插入HTML标签。

几乎所有Markdown引擎都会将其解析为输出中的强行换行。

段落

在Markdown中，两个换行符表示创建一个新段落，在Typora中，当您Enter按键时，将创建一个新段落，并且如果切换到源代码模式，则会插入两个换行符。

常用快捷键

没有macOS系统的电脑，所以暂未收集。

段落

功能 操作步骤 Windows macOS
一级标题 段落→一级标题 Ctrl+1 command+1
二级标题 段落→二级标题 Ctrl+2 command+2
三级标题 段落→三级标题 Ctrl+3 command+3
四级标题 段落→四级标题 Ctrl+4 command+4
五级标题 段落→五级标题 Ctrl+5 command+5
六级标题 段落→六级标题 Ctrl+6 command+6
段落 段落→段落 Ctrl+0 command+0
提升标题级别 段落→提升标题级别 Ctrl+= command+=
降低标题级别 段落→降低标题级别 Ctrl+- command+-
插入表格 段落→表格→插入表格 Ctrl+T
下方插入行 段落→表格→下方插入行 Ctrl+Enter
删除行 段落→表格→删除行 Ctrl+Shift+退格
代码块 段落→代码块 Ctrl+Shift+K
公式块 段落→公式块 Ctrl+Shift+M
有序列表 段落→有序列表 Ctrl+Shift+[
无序列表 段落→无序列表 Ctrl+Shift+]
增加缩进 段落→缩进→增加缩进 Ctrl+]
减少缩进 段落→缩进→减少缩进 Ctrl+[

格式

功能 操作步骤 Windows macOS
加粗 格式→加粗 Ctrl+B
斜体 格式→斜体 Ctrl+I
下划线 格式→下划线 Ctrl+U
删除线 格式→删除线 Ctrl+Shift+5
代码 格式→代码 Ctrl+Shift+`
超链接 格式→超链接 Ctrl+K
清除格式 格式→清除格式 Ctrl+\

视图

功能 操作步骤 Windows macOS
显示/隐藏侧边栏 视图→显示/隐藏侧边栏 Ctrl+Shift+L
查找/替换 Ctrl+F
源代码模式 视图→源代码模式 Ctrl+/
实际大小 视图→实际大小 Ctrl+Shift+9
放大 视图→放大 Ctrl+Shift+=
缩放 视图→缩放 Ctrl+Shift+-

以下是Markdown语法教程

概述

据 GitHub Flavored Markdown（GFM）官方文档介绍，Markdown是由约翰·格鲁伯（John Gruber）在亚伦·斯沃茨（Aaron Swartz）的帮助下开发，并在2004年发布的标记语言。
其设计灵感主要来源于纯文本电子邮件的格式，目标是让人们能够使用易读、易写的纯文本格式编写文档，而且这些文档可以转换为HTML（Hyper Text Markup Language，超文本标记语言）文档。
简单点说，Markdown就是由一些简单的符号（如*/-> [] （）#）组成的用于排版的标记语言，其最重要的特点就是可读性强。

目前最流行的扩展语法是GitHub Flavored Markdown，简称GFM，毕竟GitHub是全球最大的程序员网站。

标题

标题支持使用两种标记：底线（-/=）和左侧#

底线（-/=）方式（不推荐）：
语法说明如下。
1）底线是=表示一级标题。
2）底线是-表示二级标题。
3）底线符号的数量至少2个。
4）这种语法只支持这两级标题。

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

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

一级标题

二级标题

方式（推荐）

语法说明如下。
1）在行首插入#可标记出标题。
2）#的个数表示了标题的等级。
3）建议在#后加一个空格。
4）Markdown中最多只支持前六级标题。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
####### 七级标题（不支持）

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

####### 七级标题（不支持）

段落

1）段落内换行，在结尾使用两个及以上空格加回车。


我就是一段普通的文字。

这段文字需要段内换行，这后面是两个空格  
这一句话是跟上面属于同一段落。

这段文字需要段内换行，这后面是html的换行标签<br/>这一句话是跟上面属于同一段落。

我就是一段普通的文字。

这段文字需要段内换行，这后面是两个空格
这一句话是跟上面属于同一段落。

这段文字需要段内换行，这后面是html的换行标签
这一句话是跟上面属于同一段落。

2）重新开始一个段落是段落后面使用一个空行来表示。

注意：Typora默认是回车就会新起一个段落。


我就是一段普通的文字。

我也是一段普通的文字。

我就是一段普通的文字。

我也是一段普通的文字。

粗体斜体删除线

粗体由两个*或两个_包裹，斜体由1个*或1个_包裹。
建议粗体使用2个*包裹，斜体使用1个*包裹，因为*比较常见，而且比_可读性更强。
删除线由两个~包裹。
语法 效果
**粗体** 粗体
*斜体* 斜体
~~删除线~~ 删除线
***斜粗体*** 斜粗体
**~~粗体删除线~~** 粗体删除线
*~~斜体删除线~~* 斜体删除线
***~~粗体斜体删除线~~*** 粗体斜体删除线

下划线

<u>下划线</u>

下划线

注释

<!--注释-->

分割线

分隔线由3个以上的*/-/_来标记。

线上面文字

***

线上面文字

---

线上面文字

___

语法说明如下。
1）分隔线须使用至少3个以上的*/-/_来标记。
2）行内不能有其他的字符。
3）可以在标记符中间加上空格。
4）上下最好都留一个空行。

线上面文字

线上面文字

线上面文字

脚注

GFM不支持

在需要添加注脚的文字后加上脚注名字[^脚注名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注，脚注前必须有对应的脚注名字。

脚注与脚注之间尽量空一行。

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Leanote[^Le] 编辑器进行书写。

[^1]: Markdown是一种纯文本标记语言

[^2]: HyperText Markup Language 超文本标记语言

[^Le]: 开源笔记平台，支持Markdown和笔记直接发为博文

使用 Markdown[1]可以效率的书写文档, 直接转换成 HTML[2], 你可以使用 Leanote[3] 编辑器进行书写。

列表

支持使用有序列表和无序列表，有序列表用数字序号+英文句号+空格+列表内容来标记，无序列表由*/+/-+空格+列表内容来标记。

有序列表

有序列表的语法如下。

数字 + . + 空格 + 列表内容

1. 列表内容
2. 列表内容
3. 列表内容
  1. 列表内容
  2. 列表内容
  3. 列表内容

无序列表

无序列表的语法如下。

*/+/- + 空格 + 列表内容， 使用 */+/-来标记无序列表的效果是相同的。

推荐使用-。

* 使用【*】无序列表
* 使用【*】无序列表
* 使用【*】无序列表

+ 使用【+】无序列表
+ 使用【+】无序列表
+ 使用【+】无序列表

- 使用【-】无序列表
- 使用【-】无序列表
- 使用【-】无序列表

  • 使用【*】无序列表

  • 使用【*】无序列表

  • 使用【*】无序列表

  • 使用【+】无序列表

  • 使用【+】无序列表

  • 使用【+】无序列表

  • 使用【-】无序列表
  • 使用【-】无序列表
  • 使用【-】无序列表

任务列表

任务列表的语法如下。

- [ ] 未勾选
- [x] 已勾选

任务列表的语法如下。
1）任务列表以-+空格开头，由 [空格/x] 组成。
2）x可以小写，也可以大写，有些编辑器可能不支持大写，所以为避免解析错误，推荐使用小写x。
3）当方括号中的字符为空格时，复选框是未选中状态，为x时是选中状态。

今日工作：
- [x] 吃
- [x] 喝
- [ ] 玩

明日计划：
- [ ] 吃
	- [x] 吃鱼
	- [ ] 吃瓜
- [ ] 玩
- [x] 睡

今日工作：

明日计划：

引用

引用由> 引用内容来标记

> 引用内容分

语法说明如下。
1）多行引用也可以在每一行的开头都插入>。
2）在引用中可以嵌套引用。
3）在引用中可以使用其他的Markdown语法。
4）段落与换行的格式在引用中也是适用的。

> 我是引用的句子。

> 这是多行引用的第一行，我的最后有两个空格  
我是第二行。

> 这是多行引用的第一行
	第二行，第二行前面有1个TAB

> 引用中可以嵌套引用
>> 我是引用中嵌套引用

> 引用中使用其他 Markdown 标记[百度](https://baidu.com)
    第二行，**加粗**和*斜体*也是支持的，第二行前面有4个空格

我是引用的句子。

这是多行引用的第一行，我的最后有两个空格
我是第二行。

这是多行引用的第一行
第二行，第二行前面有1个TAB

引用中可以嵌套引用

我是引用中嵌套引用

引用中使用其他 Markdown 标记百度
第二行，加粗和斜体也是支持的，第二行前面有4个空格

图片

插入图片的语法如下。

![alt](/url "title")

语法说明如下。
1）alt在图片无法显示时显示的文字,title是鼠标放上去提示文字，都可以为空。
2）图片地址可以是本地图片的路径也可以是网络图片的地址。
3）本地图片支持相对路径和绝对路径两种方式。

![百度](https://www.baidu.com/img/PCfb_5bf082d29588c07f842ccde3f97243ea.png "百度一下，你就知道")

百度

链接

文字链接

文字链接就是把链接地址直接写在文本中。语法是用方括号包裹链接文字，后面紧跟着括号包裹的链接地址，如下所示。

[link](/uri "title")

[百度](https://baidu.com "百度一下，你就知道")

百度

引用链接

引用链接是把链接地址作为变量先在Markdown文件的页尾定义好，然后在正文中进行引用。其语法如下。

[link][link reference]

[link reference]: /uri "title"

[百度][baidu]
[baidu]: https://baidu.com "百度一下，你就知道"

百度

网址链接

将网络地址或邮箱地址使用<>包裹起来会被自动转换为超链接。其语法如下。

<URL或邮箱地址>

<https://baidu.com>

<liudehua@162.com>

https://baidu.com

liudehua@162.com

锚点

网页中，锚点其实就是页内超链接，也就是链接本文档内部的某些元素，实现当前页面中的跳转。

[锚点描述](#锚点名)

[回到标题](#标题)

回到标题

代码

行内代码

行内代码引用使用`包裹，语法如下。

`代码`

使用`cd ..`命令切换到上一级目录

使用cd ..命令切换到上一级目录

代码块

代码块以Tab键或4个空格开头，语法如下。

以TAB键开头：
	def print():
	pass
	
或者以4个空格开头：
    def print():
    pass

以TAB键开头：

def print():
pass

或者以4个空格开头：

def print():
pass

围栏代码块

在基础语法中，代码块使用Tab键或4个空格开头；在扩展语法中，围栏代码块使用连续3个`或3个~包裹，还支持语法高亮，可读性和可维护性更强一些。

围栏代码块语法如下。

\```无编程语言名称
​```
代码片段
​```

\```有编程语言名称
​``` java
代码片段
​```

\~~~无编程语言名称
~~~
代码片段
~~~

\~~~有编程语言名称
~~~ java
代码片段
~~~

语法说明如下。
围栏代码块使用连续3个`或3个~包裹，支持语法高亮并可以加上编程语言的名字。

“`无编程语言名称

String name = "Tom";
int age = 18;

“`有编程语言名称

String name = "Tom";
int age = 18;

~~~无编程语言名称

String name = "Tom";
int age = 18;

~~~有编程语言名称

String name = "Tom";
int age = 18;

表格

表格的语法如下。

|表头1| 表头2 | 表头3|
|---- | ---- | ----|
|内容1 | 内容2 | 内容3|
|内容1 | 内容2 | 内容3|

语法说明如下。
1）单元格使用|来分隔，为了阅读更清晰，建议最前和最后都使用|。
2）单元格和|之间的空格会被移除。
3）表头与其他行使用-来分隔。
4）表格对齐格式如下。
左对齐（默认） :-
右对齐 -:
居中对齐 :-:
5）块级元素（代码区块、引用区块）不能插入表格中。

关于创建表格的建议如下。
1）在表格的前、后各空1行。
2）在每一行最前和最后都使用|，每一行中的|要尽量都对齐。
3）不要使用庞大复杂的表格，那样会难以维护和阅读。

普通表格
| 序号 | 标题 | 网址 |
| --- | ---- | --- |
| 01  | 博客  |https://cnblogs.com|
| 02  | 百度  |https://baidu.com|


对齐表格
| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :----: | ---: |
| 01  | 博客  |https://cnblogs.com|
| 02  | 百度  |https://baidu.com|

表格使用其他标记
| 序号 | 标题 | 网址 |
| --- | ---- | --- |
| **01**  | [博客](https://cnblogs.com)  |https://cnblogs.com|
| *02*  | [百度](https://baidu.com "百度一下，你就知道")  |https://baidu.com|

普通表格

序号 标题 网址
01 博客 https://cnblogs.com
02 百度 https://baidu.com

对齐表格

左对齐 居中对齐 右对齐
01 博客 https://cnblogs.com
02 百度 https://baidu.com

表格使用其他标记

序号 标题 网址
01 博客 https://cnblogs.com
02 百度 https://baidu.com

表情符号

语法 效果
:smile:
版权声明：本文为deeround原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://www.cnblogs.com/deeround/p/14831776.html