showumd一键批量转换md为html并部署于本地或服务器
Author : zbzhen, Modified : Mon Apr 22 14:03:55 2024
下载地址
最新版本
https://kz16.lanzn.com/isAMv1w42zaf
密码:6666
老版本
https://kz16.lanzouw.com/ii7dB1hbto1e
密码:6666SHA256: 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 用于显示公式