V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
Daring Fireball: Markdown
CommonMark
MacDown Open Source Markdown Editor
Marked
GitHub Flavored Markdown
amoblin
V2EX  ›  Markdown

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

  •  1
     
  •   amoblin · 2015-11-07 14:38:45 +08:00 · 6663 次点击
    这是一个创建于 3306 天前的主题,其中的信息可能已经有所发展或是发生改变。

    Marboo 是什么

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

    Marboo 适用用户

    Marboo 适用于以下用户:

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

    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
    2. ePub
    3. pdf
    4. CSV
    5. Zip
    6. Images
    7. Audio/Video
    8. 源代码文件

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

    Markdown :

    ePub :

    Pdf :

    支持的文档系统类型

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

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

    Marboo 相关网址

    21 条回复    2018-12-16 11:32:44 +08:00
    lhrkkk
        1
    lhrkkk  
       2015-11-07 14:56:19 +08:00
    设计更加合理, 做的越来越好了
    lizhenda
        2
    lizhenda  
       2015-11-07 15:20:33 +08:00
    不错,试用一下~
    Mikex
        3
    Mikex  
       2015-11-07 15:25:02 +08:00
    码农必备神器+1 : MacBook Pro, HHKB Pro, Marboo Pro 一个都不能少
    edwardaa
        4
    edwardaa  
       2015-11-07 15:28:21 +08:00
    markdown 的 app 真是太多了,我表示已经眼花缭乱了。。。
    hei1000
        5
    hei1000  
       2015-11-07 15:30:31 +08:00 via Android
    @edwardaa 是啊,我已经见过好多款了,虽然我没有兴趣但是感觉很容易就可以做出来的样子
    amoblin
        6
    amoblin  
    OP
       2015-11-07 15:34:18 +08:00
    @edwardaa Marboo 已开发了 3 年多,一直专注于以下几点: 1. 如何高效预览? 2. 如何和编辑器无缝配合使用? 3. 如何和命令行无缝配合?这是 Marboo 的特色。而且, Marboo 不仅仅是支持 Markdown 的呢~
    amoblin
        7
    amoblin  
    OP
       2015-11-07 15:41:48 +08:00   ❤️ 1
    @hei1000 只做 Markdown 的编辑和预览或许比较容易,但 Marboo 不是这样的。 Marboo 不做编辑,只做预览。不仅可以预览各种标记语言,而且可以通过自定义配置,支持各种文件的预览,这个并不简单。我在早期的文章里写过, Marboo 实现的是一个机制,用户自己定义从文件到最终的 HTML 页面的映射函数, Marboo 执行这个函数,然后把 HTML 页面展示出来。 Markdown 的预览是一个映射函数,其他如 RST 、 Org-mode 的预览也是一个个映射函数, ePub 、 PDF 的预览,都是映射函数。
    loshine1992
        8
    loshine1992  
       2015-11-07 16:16:16 +08:00
    试用了一下感觉不错,希望可以加入`kotlin`的语法高亮
    hei1000
        9
    hei1000  
       2015-11-07 16:33:47 +08:00 via Android
    @amoblin 没有编辑?应该介绍里面明确说清楚哦,而且,预览和管理做好了,编辑功能还是很有必要的吧
    loshine1992
        10
    loshine1992  
       2015-11-07 16:40:06 +08:00
    希望可以加入修改默认 terminal 的选项。
    xuelang
        11
    xuelang  
       2015-11-07 19:28:19 +08:00
    我表示刚买了 MWeb ,比这个还强大
    amoblin
        12
    amoblin  
    OP
       2015-11-07 19:30:38 +08:00
    @loshine1992 语法高亮使用的 Prism.js ,你可以去 Prism.js 官网下载 kotlin lang 的语法高亮包,然后放到 marboo 里替换掉现有的 prism 包就可以了。 在配置文件 marboo_config.json 中修改默认 terminal : "folder_terminal_viewer": "iTerm2"
    amoblin
        13
    amoblin  
    OP
       2015-11-07 19:39:45 +08:00   ❤️ 1
    @hei1000 Marboo 不带编辑功能的。原因有三。 1 ,因为 Markdown 的编辑器已经太多了,没有必要重复造轮子。 2 , Marboo 支持的不仅仅是 Markdown 文件,还有 RST 、 Org 等,不同标记语言的用户使用的编辑器很可能是不一样的,一款编辑器做的再好也不可能满足所有需要。 3 ,也是最重要的原因, Marboo 遵循 UNIX 的 KISS 哲学,专注预览,同时提供良好的接口来和编辑器配合使用。
    orzfly
        14
    orzfly  
       2015-11-07 19:57:05 +08:00
    对自定义文件转换器比较感兴趣,但是为啥帮助是空白的呢?

    https://amoblin.gitbooks.io/marboo-guide/content/zh-cn/05-custom-settings/5.7%20custom-file-convert.html
    amoblin
        15
    amoblin  
    OP
       2015-11-07 20:03:52 +08:00
    @xuelang MWeb 和 Marboo 完全不是同一类型的,没有什么可比性。 MWeb 和 Ulysses 类似,是 Markdown 编辑器,侧重于编辑。而 Marboo 是标记语言管理和预览工具,侧重于展示阅读,如需编辑则调用设置的编辑器。
    amoblin
        16
    amoblin  
    OP
       2015-11-07 20:14:01 +08:00   ❤️ 1
    @orzfly 赞,一下子就看到最核心的部分啦! Marboo 内置的转换基本上能满足大部分需求了,需要自定义文件转换器的需求不多,所以这一部分的文档还没有来得及完善。你可以先看一下 .media/packages 下的包,其中的 markdown 包包含处理 Markdown 文件的所有资源,参考这些包来写一个包,就可以实现自定义文件的自定义转换了。具体文档等我写好了告诉你 :)
    IMRES
        17
    IMRES  
       2015-11-07 21:49:01 +08:00
    看起来不错,下次试试
    loggerhead
        18
    loggerhead  
       2015-11-08 10:35:00 +08:00
    适用了一下,觉得挺不错的就买了。有一些问题和建议:
    1. **偶尔** 会出现下图所示情况
    ![Marboo problem]( https://ooo.0o0.ooo/2015/11/07/563eb1e58efa0.png)

    2. 预览有问题(包括 LaTeX 公式),如下图,对应的 markdown 文件在 [Gist]( https://gist.github.com/loggerhead/08acb0d1ee12c96d82dd) 可以看到
    ![AES 加密算法的实现.md oodad 10-31-11.png]( https://ooo.0o0.ooo/2015/11/07/563eb421d4b29.png)

    3. 增加 TOC 支持

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

    5. 增加全屏模式
    amoblin
        19
    amoblin  
    OP
       2015-11-09 10:19:57 +08:00
    @loggerhead 1. 这个可能是有些预览文件在转换时遇到沙盒权限限制导致的,具体原因要看具体情况; 2 Markdown 中支持 Latex 公式的,但需要联网才可以,默认是没有开启的,通过修改配置文件可以开启; 3 、 4 、 5 这些特性接下来陆续会增加的。加一下 Marboo QQ 群吧: 273540092 方便沟通~
    whoomin
        20
    whoomin  
       2015-11-09 11:12:18 +08:00
    功能很赞,已买 Pro 版。
    leyle
        21
    leyle  
       2018-12-16 11:32:44 +08:00
    作者已经放弃开发这个软件了吗?
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1781 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 27ms · UTC 16:39 · PVG 00:39 · LAX 08:39 · JFK 11:39
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.