最近一直用 iA Writer 做笔记,用不同的文件保存不同的主题,由于 iA Writer 并没有很好的管理和浏览功能,于是就想做个 Web 工具方便浏览和管理。
markdown-wiki 是我用 Sinatra 做的一个简单的预览工具,它可以把某个目录下的 Markdown 文件以 Wiki 的形式呈现出来。界面上借用了 Ghost 的 CSS,可以在 http://markdown-wiki-demo.herokuapp.com/ 预览(因为是非本地的内容,上方的 Edit 按钮没有作用)。
Markdown 语法方面,由于用了 redcarpet 所以有不少语法扩展,包括代码块、删除线、下划线、上标等,另外包含了 Wiki 内部链接支持。
安装说明
- 下载源代码
- 安装 Ruby 和 bundle
- 在项目目录下运行
bundle install
- 将 app.rb 中的 WIKI_ROOT 改成 Markdown 文档所在的目录
- 运行 mac/webeditor opener.app
安装后在项目目录下运行 rackup
(如果要限制只能本地访问可以运行 rackup -o localhost
),并访问 http://localhost:9292 即可。
本地编辑器(目前只支持 Mac 系统)
在网页上打开本地编辑器的功能是通过 URL Scheme 实现的,mac/webeditor opener.app 会将 wikieditor:// 注册给一个 AppleScript,后者负责运行 iA Writer 并打开相应的文件。mac/ 下已经包含了预先打包好的 app 文件,如果你需要修改 AppleScript,可以打开 mac/webeditor opener.scpt,编辑完成后点击 File -> Export,在 File Format 中选择 Application,并将 mac/Info.plist 放到新生成的应用包中。
如果在打开 iA Writer 时提示权限问题,请先在 iA Writer 中手动打开一次需要编辑的文件,之后就能顺利编辑这个目录下的所有文件了。
其他功能
目前功能比较简单,有几个接下来考虑加入的功能:
- 文本搜索
- 目录支持
- 其他编辑器的支持
源代码在 GitHub 上,欢迎提供建议和 Pull Request。
转载请注明:爱开源 » 本地 Markdown 预览工具