Markdown（编辑器）工具与使用总结&Markdown语法图文全面详解_markdown编辑

     对于markdown文档格式因网络文章、云笔记的兴起，及开源代码的文档应用，现已变更越来越来流行。markdown不止是HTML的简化版，更重要的是txt的升级版、word的轻量版、是笔记的最佳载体。markdown以编辑及保存纯文本方式，写作中添加简单符号即完成排版，所见即所得，让你专注于文字而不是排版，并可以轻松转换为 html、pdf等。

       对于普通人或一般开发者，我们看下支持Markdown的编辑器有哪些合适我们使用，看完可使少走弯路，我对比了几款免费的Markdown编辑软件，希望对大家有帮助。

• 一、首先较多的是在线的Markdown编辑器

在线的Markdown编辑器有dillinger、Vditor等，还有不少浏览器插件支持的Markdown编辑，但这是这篇文章介绍的重点，我们主要介绍下现流行好用本地运行并且免费的Markdown编辑器有哪些。

• 二、能本地运行的免费Markdown编辑器

刚开对Markdown编辑器并未重视，以为这个小功能，很多软件都可做好，当我在进行一个新项目开展时，因为是敏捷项目，所以要在README.md中将说明及计划等一并说明，就离不开Markdown的编辑浏览。用了几个工具，发现要用好Markdown也不是那么简单的，重点是要有好的编辑器。刚开始用MarkdownPad2用得一脸蒙，是一个英文软件不说，还不能即时预览，介绍是说：多功能Markdown编辑器。但用起很不顺手就放弃了，继续找了几款软件进行了对比。在软件管家上查，Markdown编辑器也真的不多呀。

1. IDEA的Markdown插件

     用了这个插件就爱上了，主要是就集成在开发工具中，使用非常方便，可见即所得，编辑与预览位置同步。

最简单的是直接在Markdown配置中安装支持的图形插件。

请打开“设置/首选项”（Ctrl+Alt+S），转到“语言和框架|Markdown”页面并单击“PlantUML框架未安装”警告旁边的Install按钮。该框架将安装到IntelliJ IDEA缓存中。

2. HBuilder X

这个是国内一个专门用于开发小程序的IDE，比较出名的就是Markdown编辑功能，是较早支持与一直号称最强大的markdown书写工具。我使用一个还是不错的，是一个小巧且强大的工具，就是markdown与预览不能同步滚动，但有个好处是有个“文件结构图”的功能，可目导航编辑。     

3.Visual Studio Code

VsCode估计大家都熟悉的，这个工具也是很早就自带支持markdown编辑功能的IDE了。但功能就一个文本的编辑功能，有预览功能也能同步滚动，就是预览功能不完整，如表格并不是完整的表格样式，这就有点奇怪了。

4. 印象笔记Markdown编辑

印象笔记是一个长青级的笔记类应用软件，并且支持多个平台（包括windows、Mac、苹果手机IOS、手机安卓端、及微信小程序等）。印象笔记顺应时代要求，也增加了支持Markdown编辑的功能，不单支持主流的 Markdown 语法，同时还支持相关样式、序号列表、任务列表、表格、TOC目录、多种图表、数学公式、流程图、时序图、甘特图等高级功能。使用起来还不错，就是并不是专业的Markdown编辑，你要打开外部*.md文件并不支持，是要在印象笔记新增笔记时选择Markdown类型笔记。

5. 跨平台的Typora

        这个Markdown编码器较精典，号称是踏平台的Markdown编辑器的标杆，用起来还是不错的，主要是支持的语法较多。

• 三、最后简单整理一下Markdown的主要标签语法

1. 标题

使用 # 号可表示 1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。

2. 段落

在Markdown的段落没有特殊的格式，直接编写文本，段落的换行号是使用两个以上的空格加回车。段落的换行是使用两个以上空格加上回车。

2.1、字体

用1个星号*或底线_表示斜体；

用2个星号*或底线_表示粗体；

用3个星号*或底线_表示粗斜体；

2.2、分隔线

可在一行中用三个以上的星号*、减号-、底线_来建立一个分隔线，行内不能有其他东西，你也可以在星号或减号蹭插入空格。

2.3、删除线

如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线（~~）即可。

2.4 下划线

下划线可以通过HTML的标签来实现：<u>带下划线文本</u>

3. 列表

3.1 有序列表

有序列表直接在文字有加上1. 2. 3. 来表示，符号和文字之间加上一个空格字符。

3.2 无序列表

无序列表使用星号(*)、加号(+)或者减号(-)作为标记。

3.3列表嵌套

列表嵌套只需在子列表的选项前添加四个空格即可。

 4. 区块

区块引用是在段落开头使用>符号，然后后面紧跟一个空格符号。另外区块是可以嵌套的，一个>符号是最外层，两个符号是第一层嵌套，以此类推。

4.1 区块中使用列表

4.2 列表中使用区块

如果要在列表项目内放进区块，那么就需要在>前添加四个空格和缩进。

5. 代码框

如果是段落上的一个函数或片段的代码可以用两个'把它包起来。'print()' 函数

5.1 代码区块

代码区块使用4个空格或者一个制表符（Tab键）；也可以用'''包裹1段代码，并指定一种语言（也可以不指定）。

6. 链接

[链接名称](链接地址) 或者 <链接地址>

高级链接：链接也可以用变量来代替，文档末尾附带变量地址。

7. 图片

开头一个感叹号!

接着一个方括号，里面放上图片的代替文字

接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的'title'属性文字。



或使用html方式：

<img src="http://www.txrjy.com/static/image/common/logo.gif" width=20%/>

像网址那样对图片使用变量：

8. 表格

|表头1|表头2|

|----|----|

|单元格11|单元格12|

|单元格21|单元格22|

-: 设置内容或标题栏右对齐

:- 设置内容或标题栏左对齐

:-: 设置内容或标题栏居中对齐

9. 支持HTML元素

不在Markdown涵盖范围之内的标签，都可以直接在文档里面用HTML撰写。

10. 转义

Mrkdown支持以下这些符号前面加上反斜杠来帮助插入普通符号。

\  反斜线

`  反引号

*  星号

_  下划线

{} 花括号

[] 方括号

() 小括号

#  井字号

+  加号

-  减号

.  英文句点

!  感叹号

 这个功能发现IDEA插件未支持。IDEA要用Markdown Editor插件支持。

11. 数学公式

需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。

需要加载 Mathjax 对数学公式进行渲染。如果是在博客园用公式，需要到自己的博客园：管理》选项，勾选“启用数学公式支持”；如果是在typora软件：文件》偏好设置》markdown》扩展语法，勾选“内联公式”；其他的md编辑器应该也是差不多需要去设置渲染公式，不然显示不出来。

这个功能发现IDEA插件、vscode与HBuilderX未支持，只有印象笔记和Typora支持。

IDEA要用Markdown Editor插件支持。

12. 文字颜色、大小、字体

通过html标签实现。

这个功能HBuilderX和Typora支持得最好，IDEA插件背景色未支持（DEA要用Markdown Editor插件支持），发现印象笔记并不支持html标签。

13. 隐藏细节

<details>

<summary>这里是摘要部分。</summary>

  这里是细节部分。

  </details>

14. 表情符Emoji

emoji使用时复制后面的md代码即可（包括两个冒号），也可以直接复制emoji表情。

发现只有Typora支持，其他几个工具都不支持md代码显示表情。

15. 计划安排（打钩）

段落前加“- [ ]“。注意的是，没有双引号，是’-’ + ‘空格’ + ‘[’ + ‘空格’ + ‘]’ + ‘空格’。

16. 流程图

显示方向：

TB/TD（ top bottom/top down）表示从上到下

BT（bottom top）表示从下到上

RL（right left）表示从右到左

LR（left right）表示从左到右

节点类型：

节点本身的展现形式，是通过不同括号来代表各自不同的形状，默认为矩形。

默认节点： A

矩形节点： B[矩形]

圆角矩形节点： C(圆角矩形)

圆形节点： D((圆形))

非对称节点： E>非对称]

菱形节点： F{菱形}

节点连线：

箭头连接 A1- ->B1

开放连接 A2- - -B2

虚线箭头连接 A3.->B3 或者 A3-.->B3

虚线连接 A4.-B4 或者 A4-.-B4

粗线箭头连接 A5==>B5

粗线开放连接 A6===B6

标签虚线箭头连接 A7-.text.->B7

标签开放连接 A8- -text- - -B8

支持定义样式：

样式写法跟矢量图（SVG）中CSS的写法一致，含有的属性有：

style 节点  样式

这个功能发现IDEA要同时安装PlantUML与mermaid插件来支持。

17. UML时序图

语法结构：

消息格式：

连接样式：一共6种箭头类型的样式：

• 实线：->
• 虚线：- ->
• 带箭头的实线：->>
• 带箭头的虚线：- ->>
• 带x的实线：-x
• 带x的虚线：- -x

激活方块：这部分有两种写法，第一种是显示通过语法实现，语法如下，会在指定对象的消息中增加，示例中李四；第二种直接在对象前面增加加减号（开始时用加号“+”，结束时用减号“-”），则在加号对应的对象上开始，减号对应的时间结束。

注释：

注释显示的位置有三个，以被标记的对象中心为参考系，基于横跨多个时，可以都逗号分隔，如示例：

• right of
• left of
• over

循环（while）：

条件（if/else）：

这个功能发现IDEA要同时安装PlantUML与mermaid插件来支持。

18. 甘特图

这个功能发现IDEA要同时安装PlantUML与mermaid插件来支持。

19. 脑图

markmap，几个工具都不支持，只有线上的Vditor支持，vs code需求另外安装markmap插件。IDEA要用Markdown Editor插件支持。

20. 图表

几个工具都不支持，只有线上的Vditor支持。

IDEA要用Markdown Editor插件支持。

21. 五线谱

几个工具都不支持，只有线上的Vditor支持。

IDEA要用Markdown Editor插件支持。

22. Graphviz

几个工具都不支持，只有线上的Vditor支持。

IDEA要用Markdown Editor插件支持。

23. Flowchart

几个工具都不支持，只有线上的Vditor支持。

节点类型：

目前官网提供7种节点，其实还有很多别的节点类型，但可能插件脚本还没支持。

• 开始（椭圆形）：start
• 结束（椭圆形）：end
• 操作（矩形）：operation
• 多输出操作（矩形）：parallel
• 条件判断（菱形）：condition
• 输入输出（平行四边形）：inputoutput
• 预处理/子程序（圣旨形）：subroutine

节点定义：

变量名=>节点标识: 节点显示名

节点连线：

变量名1->变量名2->...->变量名n

连线样式：设置变量m和变量n之间连线的样式，具体样式由变量n后面key-value控制，需要两个变量之间有直接连线。语法中的连接符为（@>）。

变量名m@>变量名n({"key":"value"})

关键字：

yes/true：condition类型变量连接时，用于分别表示yes条件的流向

no/false：同上，表示否定条件的流向

left/right：表示连线出口在节点位置（默认下面是出口，如op3），可以跟condition变量一起用：cond(yes,right)

path1/path2/path3：parallel变量的三个出口路径（默认下面是出口）

节点状态：为节点设置不同的状态，可以通过不同的颜色显示，其中状态包括下面6个，含义如英文所示，不过CSDN中好像目前还不支持。

• past
• current
• future
• approved
• rejected
• invalid

IDEA要用Markdown Editor插件支持。

24. 可视化差异

```diff

  function addTwoNumbers (num1, num2) {

-  return 1 + 2

+  return num1 + num2

}

  ```

发现只有Typora和印象笔记支持。IDEA要用Markdown Editor插件支持。

        希望大家能一如既往开心愉快！不管大环境如何，都能保持一颗积极乐观的心态，用心对待生活。有一技在身走遍天下也不怕！♥

        关注我，一有时间就分享干货与IT技术；陪你一起成长，遇见最好的自己。