showumd一键批量转换md为html并部署于本地或服务器

Author : zbzhen,        Modified : Mon Apr 22 14:03:55 2024

下载地址

最新版本

https://kz16.lanzn.com/isAMv1w42zaf
密码:6666

老版本
https://kz16.lanzouw.com/ii7dB1hbto1e
密码:6666 SHA256: f4e7e1618dfb67b334db9d397a456ea417d502fc3e5c2c682d5e3511613e61c9

• 推荐用7-zip解压, https://www.7-zip.org/a/7z2301-x64.exe

• 推荐使用 vscode 编辑和预览md文件, 更多md教程参考 https://kz16.top/md 如果vscode不方便下载, 也可以用 VSCodium

why showumd

• Markdown 可以渲染动态交互文档, 支持复杂的公式, 也支持音视频. Markdown转doc与tex或html非常方便, 而且兼容性特别强.

• 信息的表达和传播的载体主要是网页(大部分app会套壳浏览器). 因此我选择md+html以及相关工具实现个人的笔记内容展现和传播.

• 个人笔记的基本需求是安全, 稳定, 简单, 方便, 免费, 开源, 免安装, 免注册登陆关注等套路

• 一直在寻找这样的软件, 希望实现: 本地编辑或修改内容之后, 可以一键上传到服务器, 同时把内容展示在个人网站上. 并且可做到, 手机电脑都能很流畅预览. 电脑端有目录树和搜索框. 经过反复摸索和测试, 发现公开的软件绝大部分背后都有着盈利的套路. 最终自己整合了好几个开源的热门项目, 实现一键批量md转html的程序(showumd), 自动上传到服务器, 并且可以完全本地化. 相比大部分笔记软件来说

• showumd的优势有:

  • 免费开源, 免安装, 免注册登陆, 无广告
  • 支持一键开启本地https服务, 一键转md为html, 一键部署本地md到服务器
  • 支持公式, geogebra交互动图, mermaid流程图
  • 支持目录树, 支持搜索
  • 支持运行md中的脚本

showumd简介

• showumd 是公益项目, 没有任何广告, 也没有任何登陆注册扫码关注等套路, 可完全免费使用, 不可商用, 仅用于学习.

• 使用 showumd 离线包出现任何问题以及纠纷等, 与本离线包制作者无关, 总之作者不承担任何责任和义务

• showumd 并不是markdown编辑器, 它的作用是离线显示或者在线部署md文件. 至于markdown编辑器, 推荐使用 vscode 或 VSCodium

• 该离线包showumd只在win系统上测试. 基于已有的开源包: mume, caddy, geogebra, FileSaver, mermaid, katex. 理论上可以支持其它系统, 不过需要自己替换相关开源的第三方包的可执行程序

第三方包清单

• mume.exe 源于: https://www.npmjs.com/package/@shd101wyy/mume, 现在已经改名为 crossnote, 协议: https://github.com/shd101wyy/crossnote/blob/develop/LICENSE.md
• caddy源于: https://github.com/caddyserver/caddy 协议: https://github.com/caddyserver/caddy/blob/master/LICENSE
• geogebra源于: https://github.com/geogebra/geogebra 协议: https://www.geogebra.org/license
• FileSaver.js源于: https://github.com/eligrey/FileSaver.js 协议: https://github.com/eligrey/FileSaver.js/blob/master/LICENSE.md
• mermaid 源于: https://github.com/mermaid-js/mermaid 协议: https://github.com/mermaid-js/mermaid/blob/develop/LICENSE
• katex.css 源于: https://github.com/KaTeX/KaTeX 协议: https://github.com/KaTeX/KaTeX/blob/main/LICENSE
• kz16.css 参考了 https://github.com/benweet/stackedit 与 https://github.com/shd101wyy/vscode-markdown-preview-enhanced 以及 https://github.com/PrismJS/prism
• md2html.exe 是通过 nuitka --standalone --onefile md2html.py打包得到

请一定要遵循各自开源包的协议
请一定要遵循各自开源包的协议
请一定要遵循各自开源包的协议

第三方包用途

• mume.exe 可把当前文件夹下面的所有md文件转化为html文件
• caddy 配合run.bat 可一键开启本地https服务, 然后可以访问 https://localhost
• geogebra 用于绘制和显示可交互动态图
• FileSaver.js 用于导出geogebra图为html
• mermaid 用于显示流程图和饼图等
• katex.css 用于显示公式