Mac 下管理和预览 Markdown 等标记语言文件的工具 Marboo 1.0 发布，增强版 Marboo Pro 1.1.1 发布！(多图)

[amoblin]

# Marboo 是什么

Marboo 是一款管理和预览 Markdown 等标记语言文件的工具。 Marboo 能令用 Markdown 等标记语言记笔记 /写博客、使用 Sphinx/Gollum/VimWiki 写 Wiki 、使用 GitBook 来出书的用户更加方便高效。

# Marboo 适用用户

Marboo 适用于以下用户：

1. 厌倦了 Evernote 等云笔记的臃肿，想用简洁高效的标记语言如 Markdown 来记笔记的用户。
2. 资深 Markdown/reStructured Text 等用户，已经有大量的标记语言文件，需要管理和预览的用户。
3. 打算使用 [GitBook]( https://www.gitbook.com) 来写书的用户。
5. 喜欢纯文本，喜欢 git ，把代码和文档、笔记一起用 git 来管理的用户（ Marboo 开发者自己就是这样的用户）。
4. 使用 Sphinx 、 Gollum 、 VimWiki 等搭建了自己的文档中心，希望更方便的浏览的用户。
5. 爱折腾，想打造自己的文档中心的用户。

# Marboo 概览

首先看一下 Marboo 的界面：


整个界面还是蛮清爽的。从左到右分为 3 栏：

左栏为目录栏，以树状结构显示本地目录，双击将在 Finder 中显示当前目录。

中栏为文件栏，显示当前目录中的文件列表，双击将用指定的编辑器打开当前文件。

右栏为内容区，显示当前文件的预览效果。 Marboo 中的文件保存后，右栏就会立刻更新预览效果。

底部为状态栏，显示当前关联的 App 和当前的路径。

## 强大的快捷键支持

Marboo 使用 Vim 风格的快捷键。不用鼠标和触控板，就可以实现所有的功能。

使用 h/l 来在左中右三栏来回切换焦点。

聚焦在目录栏时，使用 j 、 k 来上下移动，使用空格来折叠展开目录，使用 o 来打开目录。

聚焦在文件栏时，使用 j 、 k 来上下移动，使用 o 来打开编辑器。

聚焦在内容栏时，使用 j 、 k 来上下滚动，使用空格来翻页，使用 o 来在浏览器中打开。

## 自动定位&&面包屑导航

不管通过什么方式，修改了 Marboo 下文件的内容，保存时 Marboo 会立刻定位到该文件并显示最新的预览效果。


使用 b 来返回上一个文件，使用 f 来前进到下一个文件，就像浏览器中的前进后退一样。

## 支持的标记语言类型

1. Markdown (支持代码高亮显示、表格、 Todo list 、脚注、 Latex 公式显示、文件链接)
2. reStructuredText
3. Org-mode
4. Textile
5. Txt2tags
6. HTML

## 其他支持的文件类型

1. Text
1. ePub
2. pdf
3. CSV
4. Zip
5. Images
6. Audio/Video
7. 源代码文件

随便放几个文件的预览效果吧。

Markdown ：


ePub ：


Pdf ：


## 支持的文档系统类型

支持 GitBook 、 Sphinx 、 VimWiki 、 Gollum 。后续会增加 Jekyll 、 Hexo 等的支持。

可以从这里 <https://github.com/marboo/CCBooks> 直接 clone 这些开源文档来本地离线阅读，显示效果如下：



## Marboo 相关网址

- 主页: <http://marboo.io>
- 用户手册: <https://amoblin.gitbooks.io/marboo-guide/content/zh-cn/index.html>
- Marboo @ Mac App Store: <https://itunes.apple.com/cn/app/marboo/id880375426?mt=12>
- Marboo Pro @ Mac App Store: <https://itunes.apple.com/cn/app/marboo-pro/id1010557319?mt=12>

[lhrkkk]

设计更加合理, 做的越来越好了

[lizhenda]

不错，试用一下~

[Mikex]

码农必备神器+1 ： MacBook Pro, HHKB Pro, Marboo Pro 一个都不能少

[edwardaa]

markdown 的 app 真是太多了，我表示已经眼花缭乱了。。。

[hei1000]

@edwardaa 是啊，我已经见过好多款了，虽然我没有兴趣但是感觉很容易就可以做出来的样子

[amoblin]

@edwardaa Marboo 已开发了 3 年多，一直专注于以下几点： 1. 如何高效预览？ 2. 如何和编辑器无缝配合使用？ 3. 如何和命令行无缝配合？这是 Marboo 的特色。而且， Marboo 不仅仅是支持 Markdown 的呢~

[amoblin]

@hei1000 只做 Markdown 的编辑和预览或许比较容易，但 Marboo 不是这样的。 Marboo 不做编辑，只做预览。不仅可以预览各种标记语言，而且可以通过自定义配置，支持各种文件的预览，这个并不简单。我在早期的文章里写过， Marboo 实现的是一个机制，用户自己定义从文件到最终的 HTML 页面的映射函数， Marboo 执行这个函数，然后把 HTML 页面展示出来。 Markdown 的预览是一个映射函数，其他如 RST 、 Org-mode 的预览也是一个个映射函数， ePub 、 PDF 的预览，都是映射函数。

[loshine1992]

试用了一下感觉不错，希望可以加入`kotlin`的语法高亮

[hei1000]

@amoblin 没有编辑？应该介绍里面明确说清楚哦，而且，预览和管理做好了，编辑功能还是很有必要的吧

[loshine1992]

希望可以加入修改默认 terminal 的选项。

[xuelang]

我表示刚买了 MWeb ，比这个还强大

[amoblin]

@loshine1992 语法高亮使用的 Prism.js ，你可以去 Prism.js 官网下载 kotlin lang 的语法高亮包，然后放到 marboo 里替换掉现有的 prism 包就可以了。 在配置文件 marboo_config.json 中修改默认 terminal ： "folder_terminal_viewer": "iTerm2"

[amoblin]

@hei1000 Marboo 不带编辑功能的。原因有三。 1 ，因为 Markdown 的编辑器已经太多了，没有必要重复造轮子。 2 ， Marboo 支持的不仅仅是 Markdown 文件，还有 RST 、 Org 等，不同标记语言的用户使用的编辑器很可能是不一样的，一款编辑器做的再好也不可能满足所有需要。 3 ，也是最重要的原因， Marboo 遵循 UNIX 的 KISS 哲学，专注预览，同时提供良好的接口来和编辑器配合使用。

[orzfly]

对自定义文件转换器比较感兴趣，但是为啥帮助是空白的呢？

https://amoblin.gitbooks.io/marboo-guide/content/zh-cn/05-custom-settings/5.7%20custom-file-convert.html

[amoblin]

@xuelang MWeb 和 Marboo 完全不是同一类型的，没有什么可比性。 MWeb 和 Ulysses 类似，是 Markdown 编辑器，侧重于编辑。而 Marboo 是标记语言管理和预览工具，侧重于展示阅读，如需编辑则调用设置的编辑器。

[amoblin]

@orzfly 赞，一下子就看到最核心的部分啦！ Marboo 内置的转换基本上能满足大部分需求了，需要自定义文件转换器的需求不多，所以这一部分的文档还没有来得及完善。你可以先看一下 .media/packages 下的包，其中的 markdown 包包含处理 Markdown 文件的所有资源，参考这些包来写一个包，就可以实现自定义文件的自定义转换了。具体文档等我写好了告诉你 :)

[IMRES]

看起来不错，下次试试

[loggerhead]

适用了一下，觉得挺不错的就买了。有一些问题和建议：
1. **偶尔** 会出现下图所示情况

2. 预览有问题（包括 LaTeX 公式），如下图，对应的 markdown 文件在 [Gist]( https://gist.github.com/loggerhead/08acb0d1ee12c96d82dd) 可以看到

3. 增加 TOC 支持

4. 增加折叠左边那两栏的选项

5. 增加全屏模式

[amoblin]

@loggerhead 1. 这个可能是有些预览文件在转换时遇到沙盒权限限制导致的，具体原因要看具体情况； 2 Markdown 中支持 Latex 公式的，但需要联网才可以，默认是没有开启的，通过修改配置文件可以开启； 3 、 4 、 5 这些特性接下来陆续会增加的。加一下 Marboo QQ 群吧： 273540092 方便沟通~

[whoomin]

功能很赞，已买 Pro 版。