MDwiki

一直在找一个方案可以方便的发布一些单个的markdown文件,用hexo或者hugo感觉太重了,每次都要编译。Obsidian也可以直接发布到wordpress但是也是需要一个庞大的wordpress系统支持,总感觉得太麻烦了。

今天找到 一个新玩意儿 mdwiki 真的太厉害,只要上传一个html文件,就可以把任何markdown文件直接用html显示出来,带css主题,非常方便。

安装

不需要任何安装。
下载一个mdwiki.html 文件上传到任何一个目录下,可以用下面的链接直接吧md变成网页:

1
http://www.example.com/mdwiki.html#!myfile.md

也就是说这样的结构

1
2
3
-- any folder
L mdwiki.html
L myfile.md

设置为index

  1. mdwiki.html 设置为 index.html
  2. 把index页面的内容新建一个 index.md 文件
  3. 直接打开域名就会显示index.md 的内容
1
2
3
-- any folder
L index.html
L index.md

页面布局

  1. 一级title#会被作为页面标题
  2. 二级title##会被作为section在页面左边悬浮导航
  3. 其他的语法可以自由markdown发挥

添加导航栏和设定主题

  1. 新建一个 navigation.md
  2. 按照下面的格式输入内容
1
2
3
4
5
# Yakumo's Navigation

[Links](01_Links.md)
[About](about.md)
[gimmick:theme](amelia)
  1. 所有页面的上方都会出现导航栏,主题会被设定,其他主题的选择到官网看有哪些填进去就可以了

完成之后文件结构是这样的:

1
2
3
4
5
6
-- any folder
L index.html
L index.md
L navigation.md
L 01_Links.md
L about.md

CSS文件无法正确加载

css文件地址无法访问。
打开mmwiki.html 或者你的 index.html, 查找到你的css文件的url
netdna.bootstrapcdn.com/bootswatch/3.0.0/cyborg/bootstrap.min.css
一个类似这样的地址,下载下来之后,手动上传到自己的主机上。
尝试了只能用url,不能用相对路径。