MarkdownPad安装以及绘制 UML 图

要在本地编辑和查看markdown 文件,我选择了安装MarkdownPad 2。
从官网下载了MarkdownPad 2,安装后打开md文件,出现了This view has crashed的渲染错误
如下:
在这里插入图片描述
同时会给出一个弹屏,可以看到更详细的信息。
在其提供的FAQ 文档http://markdownpad.com/faq.html#livepreview-directx中给出了解决该问题的办法

在页面中搜索上述错误This view has crashed
在这里插入图片描述
上面说我们需要下载 一个 Awesomium 1.6.6 SDK , 我点击链接无法打开,所以直接从网上找了一个,我上传到资源里了, 下载安装后再打开md文件渲染就正常了

如果安装Awesomium 1.6.6 SDK后还是有问题,可以按照文档上的建议下载安装 Microsoft’s DirectX End-User Runtimes

同事创建的md文件中使用了PlantUML来画UML时序图(他是通过VsCode在md中集成PlantUML的,参考:VSCode 中使用 PlantUML 插件生成 UML),但是在我的MarkdownPad 2里无法正常展示,查阅了一下资料发现如果我们想在markdown文件里使用PlantUML图,有两种方式:

1.把图片地址集成到 Markdown 里面

集成方式又可以分为三种

1) 在线编写代码生成 UML 图片.然后再把图片地址集成到 Markdown 里面

可以通过http://www.plantuml.com/plantuml/uml/SyfFKj2rKt3CoKnELR1Io4ZDoSa70000 在线编写代码,生成图片,如下:

在这里插入图片描述
点击下方的submit按钮就可以生成下面的预览图和对应的图片url

在这里插入图片描述
在这里插入图片描述
2)对url进行编码后,把图片地址集成到 Markdown 里面
编码网站

Bob -> Helen: hello编码后的字符串如下:

Bob%20-%3E%20Helen%3A%20hello%0A

拼接上http://g.gravizo.com/svg?后就可以在markdown里面使用了
在这里插入图片描述

3)不编码使用<>将网址括起来,把图片地址集成到 Markdown 里面
在这里插入图片描述

在这里插入图片描述
注意<>中的url连接不能有回车符号,但可以有空格

2),3)方法的缺点在于对于比较复杂的代码并不合适,相对比较适合于类图的引用,对于复杂的时序图一般无法很好的展示想要的UML图;而1)对于任何使用PlantUML 代码描绘的UML图都能正常展示

2.使用Gravizo 绘图引擎

只需要用 Url 包含 PlantUML 代码放到一个 img 标签中,就可以在线实时的绘制出我们需要的 UML 图。如下 :

<img src='https://g.gravizo.com/svg?
abstract class AbstractList;
interface List;
List <|.. AbstractList;
'/>

当然这个也需要集成的 Markdown 里面支持 Gravizo 才能显示出来,我的Markdown Pad不支持Gravizo 就不能使用上述办法了

对PlantUML感兴趣的,可以看下如下文章21分钟入门UML 或者官网了解下PlantUML的语法。相比较其他的UML画图工具,PlantUML的语法还是比较简单的,而且在调整UML图的时候也不需要我们一点点去修改线条什么的。

参考资料:
Markdown 绘制 UML 图 – PlantUML + Gravizo
markdown+gravizo画UML类图

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值