markdown转html工具之mdtool.jar

markdown转html工具之mdtool.jar

作者:ShibaInu

使用“富文本编辑器”:浏览器打开html文件,然后直接复制粘贴过来即可完成这篇文章。

markdown入门

这里假设大家已经熟悉markdown的语法,并了解markdown所带来的优点。

假设从未接触和使用过markdown,那么可以参考下面这个资料:Learning-Markdown (Markdown 入门参考)

推荐的markdown编辑器:typora

markdown文件传输的缺点

markdown文件在传输过程中,如果存在本地图片、gif等文件的引入,那么将很不利于传输发送给其他人。

尝试过的解决方案是:转为word、pdf、html等进行传输

尝试过的工具:typora,pandoc,i5ting_toc等(还有其他的忘记了)

最后我决定选择转为html的方案,因为我打算放到网上,方便保存和随时随地查看。

这些工具都不能完美的解决我的需求,因为我希望转为html文件后,图片要被压缩进html文件中,方便传输,而且文件体积也会减小。

markdown转换工具mdtool.jar

下载:关注微信公众号【浅谈java全栈技术】回复『 md转换工具』

使用

配置Java运行环境

参考:JDK8的安装和配置

文件说明

配置工具环境

修改.bat脚本

脚本说明

  • mdtool.bat:转换单个markdown文件
  • mdtools.bat:转换当前文件夹下的所有markdown文件,即批量转换

验证

单个文件转换:mdtool(只需要输入不包含拓展名的markdown文件名即可)

多个文件转换(批量转换):mdtools

存在的问题(不影响使用):例如转换markdown文件的时候,如果图片不存在,即本地图片路径下找不到这个图片,会如下报错:

在markdown文件中放置了一个空图片引入代码<img src="" alt="" height="100%" width="100%"/>报错。(没有指定图片路径)


java.io.FileNotFoundException:
        at java.io.FileInputStream.open0(Native Method)
        at java.io.FileInputStream.open(FileInputStream.java:195)
        at java.io.FileInputStream.<init>(FileInputStream.java:138)
        at org.itheima.tools.markdown.MarkdownUtils.base64Image(MarkdownUtils.java:119)
        at org.itheima.tools.markdown.MarkdownUtils.getBody(MarkdownUtils.java:95)
        at org.itheima.tools.markdown.MarkdownUtils.toHtml(MarkdownUtils.java:61)
        at org.itheima.tools.markdown.MarkdownUtils.toHtml(MarkdownUtils.java:39)
        at org.itheima.tools.markdown.MarkdownUtils.toHtml(MarkdownUtils.java:34)
        at org.itheima.tools.markdown.App.main(App.java:27)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
        at java.lang.reflect.Method.invoke(Method.java:498)
        at org.eclipse.jdt.internal.jarinjarloader.JarRsrcLoader.main(JarRsrcLoader.java:58)

查看生成后的文件

查看生成后的html文件是否实现了以下功能:

  • 结构化的目录
  • 目录是否包含滑动条
  • 目录是否包含锚点定位,可以跳转到目录指定的位置
  • png/jpg静态图片和gif动态图片是否压缩进去,gif图片是否正常显示动态效果

打开生成的文件,发现这些功能都实现了,真的是非常的好!

"Learning Markdown Write for the Web Faster.pdf" 是一份学习使用 Markdown 语法撰写网页的指南。Markdown 是一种轻量级的标记语言,用于简化网页编写过程并提高效率。这份指南介绍了如何使用 Markdown 语法编写文本,以及如何添加格式、链接、图片和表格等元素。 首先,这个文件会教会我们如何使用 Markdown 的基本语法。Markdown 使用一些简单的符号和约定来表示文本的格式,例如使用星号表示斜体或加粗,使用井号表示标题级别,使用减号或星号表示列表等等。这样的语法规则非常容易上手,而且可以减少繁琐而重复的 HTML 标签输入。学习和熟练掌握 Markdown 语法可以大大提高我们撰写网页的速度。 其次,这份指南还介绍了Markdown如何添加链接和图片。在 Markdown 中,我们可以使用简短的语法将链接和图片插入到文本中,而无需编写冗长的HTML代码。这使得在网页中添加外部链接或显示图片变得更加简单和高效。 最后,这份教程还指导我们如何创建和编辑表格。在Markdown中,我们可以使用简单的符号和对齐方式来创建和修改表格,并且可以轻松地在其中添加或删除行和列。这样一来,我们在编写网页时需要用到的简单表格就可以直接使用Markdown语法来创建,而不需要复杂的HTML代码。 总而言之,"Learning Markdown Write for the Web Faster.pdf" 提供了一个方便快捷的学习指南,帮助我们掌握使用 Markdown 语法来更快地撰写网页。通过学习和应用 Markdown,我们可以以更高效和简洁的方式创建和编辑网页内容,提高工作效率并节省时间。
评论 5
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值