Quicker动作：Wolai大纲文本转MarkMap思维导图（对于其他Markdown文章均适用）

最新指导请参考: https://www.wolai.com/autolab/rqah9pisN66LbvsJj6dpZB?theme=light

一、背景

Wolai暂时不支持在笔记中进行大纲文字与思维导图的转换。 （注：2022-06官方已经支持大纲节点转换导图模式，Markmap仍然有其优点，比如节点中直接过滤普通文本，只显示节点，可以对通篇文章形成完整的思维导图。）

在等待官方正式功能加入之前，正好看到MarkMap github项目。MarkMap 集合Markdown，Mindmap功能，可以将markdown转成导图形式。

看过markmap网站的这个demo之后，通过尝试，用quicker动作搭建一个简单的Wolai大纲文本转MarkMap快捷方式。

二、环境搭建步骤

• MarkMap

  • Node.js（npm）环境安装：

    • Node.js 安装配置 | 菜鸟教程

  • 下载 markmap Master并安装项目

    • 软件包

    • 解压至本地目录 C:\Tools\MarkMap\

    • 利用npm启动安装项目：

      • 切换到项目路径下：cd ..\markmap-master\packages

      • 执行npm install -g markmap-cli

    • 命令行中运行 markmap -h，如果正确显示帮助信息则说明安装已经成功

• Quicker

  • 复制地址，添加到Quicker动作中。

    * https://getquicker.net/Sharedaction?code=e352b04b-a2f3-4946-53fe-08d98467374f

  • 对这个动作右键在“偏好设置”中设置工作目录 C:\Tools\MarkMap\Temp， 后续临时md和html文件都将按照日期时间命名放在该目录下。

    • 示意图

      
      

• 日常操作

  • 选中大纲文本块，Ctrl+C

  • 执行Quicker动作：转MarMap

  • 弹出新网页页面显示mindmap

三、md 文件书写注意

在 markdown 文件的书写过程中，我们应该注意哪些标签的文本会展示在思维导图上，哪些标签可以作为 “父元素” 展开节点，哪些标签只能作为子项。

1、markmap 支持转换为导图父元素节点的标签

标题系列

2、只能作为子节点的标签

列表、引用、单行代码、代码块、数学公式

3、编写逻辑

这就要求我们在写 markdown 文件时：

• 凡是下方有分支的，都写作标题。
• 凡是想在思维导图上显示的，都写作标题、引用、单行代码、代码块、数学公式中的一个。
• 不想在思维导图上显示的，即正文部分。

4、实例：如编写如下导图的思路：

# 节点1
> 文本1
## 节点2 
* list item1
* list item2
# 节点2

参考资料：

Node.js 安装配置 | 菜鸟教程

markmap，将markdown文件转换为思维导图 - 断鸿_Hua - 博客园

C:\Tools\MarkMap\markmap-master\packages>markmap -h
Usage: cli [options] <input>

Create a markmap from a Markdown input file

Options:
  -V, --version          output the version number
  --no-open              do not open the output file after generation
  --no-toolbar           do not show toolbar
  -o, --output <output>  specify filename of the output HTML
  -w, --watch            watch the input file and update output on the fly, note that this feature is for development only
  -h, --help             display help for command

诚挚邀请您注册并体验 wolai. 两种方法注册:
* 点击邀请链接注册：https://www.wolai.com/signup?invitation=6I37QSP
* 在https://www.wolai.com注册时填写邀请码：6I37QSP