Madoko 是微软研究院之前推出的一款在线 Markdown 编辑器，只不过更加偏向学术使用，主要亮点在于 Madoko 可以和 LaTeX 结合，支持 LaTeX 一些语法和功能。

LaTeX 是一种基于 TEX 的排版系统，功能非常强大，不少写学术论文的研究者们应该都用过，但其比较底层，学习曲线和难度也挺大。Madoko 可以将 LaTeX 与简单的 Markdown 语法相结合，大部分的文档格式和结构可以使用现有的 Markdown 语法，用户也可以使用 LaTeX 的语法和命令进行扩展，可以很轻松地生成 LaTeX 排版效果的文档，默认也支持输出 HTML 和 PDF 文档。

Madoko 官方的在线编辑器 Madoko Editor 网站是：

https://www.madoko.net/

最近 Madoko Editor 网站访问有点问题，不过我之前也已经把 Madoko Editor 网站备份过了，能够自行部署运行，编辑器的界面和默认的示例文档如下：

可以看到 Madoko 文档的扩展名是 mdk，而且 mdk 文档基本都是使用现有的 Markdown 语法加上一点 LaTeX 语法，即使不使用 Madoko Editor，也可以用其它 Markdown 编辑器打开进行编辑。

Madoko Local

mdk 文档在 Madoko Editor 中编辑修改之后，支持保存到 Dropbox、GitHub、OneDrive 以及 Local Disk 本地：

由于众所周知的原因，前面三个存储目标国内用起来都不太稳定，而且之前我使用 Madoko 的时候就发现用这些云存储进行文档编辑似乎也容易出问题，可能就用微软自己的 OneDrive 做存储稳定一些。

另外考虑到数据放在自己手里才是最安全的，因此我一般都是用 Local Disk 本地保存方式。

Madoko 的本地磁盘访问则需要 Madoko Local 这个程序的配合，另外如果想要本地生成 PDF 也需要使用 Madoko Local。

Madoko Local 是用 Node.js 编写的，本机安装完 Node.js 环境后，运行命令完成安装之后就可以使用 madoko-local 命令了：

~# npm install -g madoko-local

madoko-local 命令使用起来也非常简单：

~# madoko-local -r -l .
listening on           : http://localhost:8080
connecting securely to : https://www.madoko.net
serving files under    : /home/zzm/Documents

---------------------------------------------------------------
access server at       : http://localhost:8080#secret=XXX
---------------------------------------------------------------

最后一个参数就是 Madoko 能够访问的本地目录，. 就表示只导出当前的目录。

Madoko Local 启动之后就会输出绑定的端口（默认为 8080）、导出的本地目录路径，最重要的是包含密码的访问地址，浏览器通过这个访问地址就可以打开 Madoko Editor 界面。

Madoko Local 程序的其它参数可以通过 madoko-local -h 命令来查询，另外也可以使用 config.json 配置文件来配置端口等参数，这里我把 Madoko Local 的监听端口改为了 18080，也可以使用 mountdir 来配置导出的本地目录：

~$ cat > ~/.madoko/config.json
{
  "port":18080,
  "secret":"XXX",
  "origin":"http://XXX",
  "mountdir":"/home/zzm/Documents"
}

配置文件所在的 .madoko 目录默认位于当前用户的主目录下，这个主目录的路径也可以通过 madoko-local 命令的 --homedir 参数进行自定义。

如果对应目录下存在有效的 config.json 配置文件，后续就可以直接 madoko-local 命令启动程序而不需要加任何参数了。

Madoko Local 问题

不过我在使用 Madoko Local 时也发现一些问题：

1. 通过 madoko-local 命令来指定端口、密码等各种参数可能存在问题；
2. 如果 madoko-local 程序默认绑定了本地 IPv6 的 ::1 地址（也就是 localhost 地址），会报 only serving localhost 错误。

为此我稍微修改了一下 Madoko Local Node.js 程序源码，生成了 Madoko Local 最新 0.9.4 版本的 patch 文件，有需要的朋友可以从下面任选一个下载：

1. Pastebin 分享链接
2. GitHub 提交

下载了 patch 文件之后，就可以进入 Madoko Local 的安装目录运行命令进行合并了（假设下载保存的文件名是 madoko-local-npm-v0.9.4.patch）：

~# cd /usr/lib/node_modules/
~# patch -p2 madoko-local-npm-v0.9.4.patch

上面命令使用的是 Linux 系统下 npm 默认的全局安装路径 /usr/lib/node_modules，其他系统可以使用 npm list -g | head -n 1 命令来确认。

为了方便，我也直接 fork 了 Madoko 的源仓库，还把自己做的其它的一些修改也提交了：

https://github.com/zohead/madoko

Madoko Local 程序的代码在 support/madoko-local 子目录下供大家参考。

最后祝跨过三年疫情的朋友们都能玩得开心 ^_^。

Zed 目前支持 zedrem 和 zedd 这两种远程编辑方式，下面分别介绍一下另，另外也说明了如何使用 Zed 自带的 Web Server。

zedrem 远程编辑

zedrem 是用 Go 语言编写的工具，按照 Zed 官网的介绍一条命令就可以安装成功，默认情况下在 VPS 上运行 zedrem 命令之后会自动连接 Zed 服务器注册并返回远程编辑地址，Chrome 应用后续的列举文件、打开文件、保存等操作都会通过 Zed 服务器进行中转，这样可以直接绕过防火墙之类的限制。

zedrem 的使用也非常简单，在 VPS 上运行 zedrem 跟上需要编辑的目录路径（不加目录参数则是直接编辑当前目录）：

root@zoserver:~# ./zedrem wiki-dir
In the Zed application copy and paste following URL to edit:

https://remote.zedapp.org:443/fs/c1e91639eede09e0be43a4cf3f22d036

Press Ctrl-c to quit.

看到上面 zedrem 命令给出的地址之后，就可以在 Zed App 的 选择项目 界面中选 Remote Folder，在出来的 Open Zedrem Folder 界面中直接输入上面的地址并点击 Open 就可以远程编辑 VPS 上的目录了。

如果你对 zedrem 默认通过 Zed 服务器进行中转的工作机制不放心的话，也可以让 Zed Chrome 应用与 VPS 服务器直接连接，首先在 VPS 上让 zedrem 作为转发服务器运行：

root@zoserver:~# ./zedrem --server
Zedrem server now running on ws://0.0.0.0:7337

然后另开一个终端再运行 zedrem 命令并增加 -u 参数指定转发服务器地址，这里可以直接填 VPS 服务器的 IP 地址或者域名：

root@zoserver:~# ./zedrem -u ws://xxx.xxx.xxx.xxx:7337 wiki-dir
In the Zed application copy and paste following URL to edit:

http://xxx.xxx.xxx.xxx:7337/fs/7d6f781a002875f0a9fb57e095f3ddec

Press Ctrl-c to quit.

刚才运行 zedrem 转发服务器的终端上也会显示新的客户端已经连接：

Client 7d6f781a002875f0a9fb57e095f3ddec connected

同样 Zed Chrome 应用也只需要输入上面 zedrem 命令给出的地址就可以进行远程编辑操作了，实际使用中也可以直接把 zedrem 的转发服务器模式放在后台运行的。

当然如果你的 Chromebook 和 VPS 的连接速度比较慢（比如在移动宽带网络下连接我的美国 VPS 可能就会比较慢），也可以在别的主机（例如使用另一台香港 VPS）上运行 zedrem 的转发服务器，并通过 -u 参数指定通过新的主机进行转发，这样也可以加快远程编辑的响应速度。

zedd 远程编辑

VPS 上安装 zedd

一般使用 zedrem 就能满足普通用户的基本远程编辑需求了，但如果你想实现远程编辑文件之后运行特定的命令等高级的需求（例如我修改的 MDwiki 系统在新增 Wiki 项目之后需要运行命令生成刷新 Wiki 目录文件），zedrem 对这种情况就无能无力了。

不过还好 Zed 也为我们提供了 Zedd 后台程序，Zedd 支持远程执行命令，而且导出远程文件系统的方式也更加高效，Zedd 远程目录也可以在 Chrome 应用的历史项目中直接显示，比较适合 Chromebook 用户。

Zedd 程序是用 Node.js 编写的，安装步骤相对 zedrem 会稍微复杂一点，其详细说明也可以参考 Zed 官方网站，首先 VPS 上需要安装 Node.js 环境，我的 VPS 使用的是 Debian 7 系统，可以通过下面的命令安装（假设你有 VPS 的 root 访问权限，同时也会自动安装必需的 Node.js 的 npm 包管理工具）：

root@zoserver:~# curl -sL https://deb.nodesource.com/setup_4.x | bash -
root@zoserver:~# apt-get install -y nodejs

安装完成之后就可以通过 npm 命令安装 Zedd 程序：

root@zoserver:~# npm install -g zedd

使用 zedd

Zedd 安装好之后可以先看看其运行帮助信息：

root@zoserver:~# zedd --help
Zedd is the Zed daemon used to edit files either locally or remotely using Zed.
Options can be passed in either as environment variables, JSON config in
~/.zeddrc or as command line arguments prefixed with '--':

   user:       username to use for authentication (default: none)
   pass:       password to use for authentication (default: none)
   remote:     bind to 0.0.0.0, requires auth, and disables
               enable-run by default
   port:       port to bind to (default: 7337)
   root:       root directory to expose (default: $HOME)
   enable-run: enable running of external programs in remote mode
   tls-key:    path to TLS key file (enables https)
   tls-cert:   path to TLS certificate file (enables https)

默认如果运行 zedd 程序不加任何参数会导出用户的主目录，而且默认也只有 localhost 本地才能访问，导出地址为：

http://127.0.0.1:7337/

当然对于我们要在 Chromebook 上远程编辑 VPS 上的文件就不能这么做了，根据情况可以在 VPS 服务器上运行 zedd 程序时：

• 增加 --remote 参数可以支持外部连接；
• 增加 --root 参数指定导出的根目录（默认为 $HOME 用户主目录）；
• 增加 --enable-run 参数可以允许执行外部命令；
• 另外可以指定 --user 和 --pass 参数配置访问的用户名和密码。

提示

为了 VPS 上文件的安全性考虑，如果你有可用的 SSL 证书的话建议使用 --tls-key 和 --tls-cert 参数，这样可以使用 https 模式替代默认的 http 模式。

例如我的 VPS 上可以这样运行 zedd 程序：

root@zoserver:~# zedd --remote --enable-run --root wiki-dir --user zeduser --pass zedpass
Zedd is now listening on http://0.0.0.0:7337
Exposed filesystem : /home/root/wiki-dir
Mode               : remote (externally accessible)
Command execution  : enabled
Authentication     : enabled

Chromebook 上要使用 Zedd 远程文件夹也比较简单，在选择项目界面中点击 Zedd Folder 进入 Open Zedd Folder 界面，该界面中就可以输入远程 Zedd 导出地址和用户名、密码：

确认之后点击 Connect 按钮连接正常的话就可以看到远程的目录树，接着就可以任意选择下面的子目录进行编辑了。

zedd 的外部命令支持

对于打开的远程 Zedd 文件夹，Zed Chrome 应用是支持运行外部命令的，首先使用 Zed 命令快捷键（默认为 Ctrl-Shift-.，我的 Chromebook 上改成了 Ctrl-Shift-C）或者点击 Tools -> Run Command 菜单项，在弹出的 Enter command 中输入 external，Zed 会自动搜索，默认匹配到的两个就是远程执行外部命令用的：

一般使用第一个 Tools:External:Insert Command Output 命令，选择该命令会让你输入需要在 VPS 主机上执行的命令及参数，并将远程命令的执行结果插入到当前所打开文件的光标位置。

如果你想要执行的命令有输出又担心影响正在打开的文件（Zed 是编辑区内容有改动就实时保存的），那可以直接打开 Zed 保留的 zed::start 只读文件并执行 Insert Command Output 操作，这样既可以看到远程命令的输出结果又不会改动其它文件的内容。

例如我打开远程 MDwiki 目录之后进行编辑之后需要进行刷新 Wiki 目录文件的操作，这就需要执行我写的 generate-index.sh 脚本。我就可以切换到 zed::start 文件并执行 generate-index.sh 远程命令并查看输出结果。当然如果你不关心输出结果，也可以不管当前打开的是什么文件，直接执行命令并附加 >/dev/null 以忽略输出：

这样配置之后我就能实现不经远程登录或同步 VPS 就能直接远程编辑 MDwiki 知识库的需求了，而且编辑完成之后直接在 Chromebook 上执行外部命令就能更新 Wiki 目录。

使用 Zed 自带 Web Server

由于我的 VPS 上的 MDwiki 目录同时也开启了 BTSync 同步，需要时也可以将远程的 Wiki 目录同步到本地，同步到 Chromebook 之后也可以使用 Zed 自带的 Web Server 功能本地查看 MDwiki 知识库。

Zed 打开 MDwiki 目录之后同样使用命令快捷键运行命令，输入 static server 进行搜索，就会匹配 Zed 自带 Web Server 的几个命令：

• Tools:Static Server:Stop
• Tools:Static Server:Start
• Tools:Static Server:Generate Full Site

选择第二个 Tools:Static Server:Start 命令启动 Zed 自带静态 Web Server，Zed 会自动打开新 Chrome 标签页显示 MDwiki 知识库，如果当前打开的项目目录下没有 index.html 或者 default.html 等文件则会自动显示文件列表。不再需要查看 Wiki 知识库时选择 Tools:Static Server:Stop 命令停止 Web Server 即可。

不过我在使用 Zed 自带 Web Server 时发现其存在不支持中文等非 ANSI 路径名以及包含特殊符号的文件名的问题，默认的文件列表页显示中文文件名同样不正确，因此我检出了 Zed 官方的 staticserver 包进行了修正，并在 GitHub 上新创建了一个仓库：

https://github.com/zohead/staticserver

测试完成之后我也为官方 staticserver 仓库创建了新的 Pull Request，只是目前还没有得到回应。

有使用 Zed 自带 Web Server 需求的朋友可以检出上面我的 staticserver 代码，并替换到 Zed Chrome 应用的 staticserver 包路径：

~/Extensions/pfmjnmeipppmcebplngmhfkleiinphhp/1.1.0_0/config/packages/gh/zedapp/staticserver

替换之后重新启动 Zed 应用再运行启动 Web Server 的命令应该就可以解决不能正常访问中文路径的问题了。

对于很多 Chromebook 用户来说，缺少比较好用的本地编辑器是一个比较普遍的困扰，特别是我这样的程序员用户对于编辑器的要求就更多一些了。有一些同学是直接通过 crouton 安装 Sublime Text、GitHub Atom 等编辑器或者各种 IDE 软件来解决。

之前我介绍过 Caret 这款 Chrome 应用商店里的文本编辑器 App，如果只是用来编辑纯文本之类的文件那 Caret 是能胜任的，如果你需要额外的一些扩展功能，那只能另寻他法了。我还尝试过第三方开发者移植的 Chrome 版 Adobe Brackets 编辑器（和 Atom 有点类似），不过使用起来还是存在各种问题就作罢了。

还好后来我还是在 Chrome 商店里找到了今天要介绍的 Zed 编辑器，Zed 的使用方式和 Sublime Text 比较类似，其主要功能可以参考官网：

http://zedapp.org/

Zed 编辑器其实是有 Chrome App 版本和 Windows、Mac、Linux 等系统下的 Standalone 版本的，Standalone 版本的功能比 Chrome App 版本要更多（例如可以直接运行本地命令等）。

对于 Chromebook 用户来说虽然默认只能用功能相对少的 Chrome App 版本，但相应的也能得到 Chrome 版本的带来的好处：

• 一处安装多处直接运行；
• 自动通过 Google Drive 同步 Zed Chrome App 配置；
• Zed Chrome App 默认自动从 Chrome 商店更新。

而且开发者考虑到日益增长的 Chromebook 用户的需求目前也在不断更新 Chrome App 版本，我们可以从 Chrome 商店 直接安装。

初步使用

Zed 编辑器启动时会提示你使用哪种界面风格，默认是不带目录树甚至隐藏了菜单栏的风格，打开编辑器会显示选择项目界面：

点击“Local Folder” 或者“Local File(s)”就可以打开本地的文件夹或文件编辑了，“Zedd Folder”和“Remote Folder”是两种直接编辑远程文件的方式后面单独再做介绍，另外 Zed 还直接支持打开 GitHub 版本库和 Dropbox 这点也比较方便。

打开具体的文件会直接显示文件内容，第一次打开某个项目文件夹的话则默认显示只读的 zed::start 内置使用介绍文件以帮助用户熟悉编辑器的各种快捷键之类的。

Zed 的文件编辑和 Sublime Text 这种类似是直接实时保存用户输入的结果，不需要单独的关闭保存操作。

通常的文件操作可以使用键盘快捷键或者 File 菜单完成：

• Ctrl-N 键新建文件；
• Ctrl-E 键打开文件；
• Alt-T 键显示目录树；
• F5 键刷新文件夹中的文件列表。

新建文件或者打开文件时会显示命令窗口，输入不存在的文件名就可以实现新建文件（当然也就可以直接在命令窗口中输入子目录路径）。

如果你在编辑的过程中需要打开另一个项目文件夹或者文件，那可以按 Ctrl-Shift-o 键显示最开始的选择项目界面，这样就不用重启 Zed App 了。

Zed 配置文件

这里先说 Zed 的配置文件是因为最常用的调出 Zed 命令窗口的默认快捷键 Ctrl-. 或 Ctrl-Shift-. 在 Chromebook 上是不起作用的，当然你也可以鼠标点击 Tools 菜单下的 Run Command 菜单项来实现，不过为了使用方便，我们还是先修改 Zed 配置文件来定制命令快捷键。

打开 Zed 编辑器开始显示的选择项目界面里可以看到 Configuration 项，使用此项就可以打开 Zed 自带的配置项目目录，默认第一次打开还是会显示 zed::start 文件，使用 Ctrl-E 快捷键或者打开菜单选择 user.json 文件进行编辑，这个就是 Zed 的用户配置文件。

默认的 user.json 用户配置文件可能是这样的（仅供参考）：

{
    imports: [
        "/default.json"
    ],
    preferences: {},
    modes: {},
    keys: {},
    commands: {},
    handlers: {},
    themes: {},
    packages: [    ]
}

我们可以在 keys 中新增一项来修改默认的运行命令快捷键：

    keys: {
        "Command:Enter Command": {
            win: "Ctrl-Shift-C"
        }
    },

例如改成上面的内容就可以使用 Ctrl-Shift-C 键调出运行 Zed 命令的窗口了。

当然对于修改主题之类的常用配置，你可以使用 Ctrl-, 快捷键或者 Configuration - Preferences 菜单项进行图形化的配置，这样也更加方便。

Zed 命令

Zed 命令的使用方式也是和 Sublime Text 比较相似，经过上面的步骤修改命令快捷键之后就可以体验 Zed 的各项命令了，Zed 的命令窗口支持模糊查找识别的功能。

Zed 相对 Chrome 商店里其它各种编辑器的一大优势就是其支持 Zed Package Manager（简称 ZPM）包管理特性，第三方开发者可以根据需要为 Zed 开发各种扩展功能包，ZPM 的介绍可以参考 Zed 官网文章，常用 ZPM 包在这里：

https://github.com/zedapp/zed/wiki/Packages

按快捷键调出运行命令的窗口后，输入 install 就可以看到默认匹配的安装 ZPM 包命令：

同样输入 installed 就可以看到默认匹配的列出已安装的 ZPM 包命令，还是比较方便的。

Markdown 编辑与预览

Zed 虽然不像 Sublime Text 那样支持多标签页功能，但也可以在一个 Zed 窗口中显示最多 3 个编辑窗口，通过快捷键可以切换：

• Ctrl-2 将窗口分割为两个编辑窗口；
• Ctrl-3 将窗口分割为三个编辑窗口（最好高分屏才这么干哈）；
• Ctrl-1 恢复为单编辑窗口；
• Ctrl-0 在多个编辑窗口之间切换焦点。

Zed 自带 Markdown 预览功能，如果编辑的是 Markdown 文件则可以通过 Ctrl-P 快捷键显示预览窗口，开启预览之后还可以多次使用 Ctrl-P 快捷键切换源 Markdown 文件编辑窗口和预览窗口的大小，当然也可以按 Ctrl-1 键关闭预览窗口。

我使用的 Wiki 系统 中的 Markdown 文件预览效果如下：

你可能从上面的截图可以看出 Zed 的 Markdown 预览功能似乎效果一般，这是因为 Zed 自带的 Markdown 预览模块对 GitHub 格式的 Markdown 文件的支持是不太好的。

不过还好已经有人为 Zed 写了一个支持 GitHub Flavored Markdown 的 ZPM 包，其项目地址如下：

https://github.com/akoenig/zed-gfm-preview

按照该项目主页的介绍，调出运行命令窗口，选择 Tools:Zpm:Installed Packages 命令准备安装新的 ZPM 包，包地址中输入 gh:akoenig/zed-gfm-preview 就可以完成安装。

安装完成之后编辑 Markdown 文件时可以通过 GitHub:Markdown:Preview 命令使用 zed-gfm-preview 方式来预览 Markdown，当然还是建议修改 Zed 用户配置文件直接将 zed-gfm-preview 配置为 Zed 默认的 Markdown 预览方式：

modes: {
    markdown: {
        handlers: {
            preview: [
                "!Tools:Preview",
                "GitHub:Markdown:Preview"
            ]
        }
    }
}

这样还是可以按默认的 Ctrl-P 快捷键直接预览 Markdown 文件：

可以看到效果也比 Zed 自带的实现好多了哦，代码块的显示也正确了。

后记

本文只是对 Zed 编辑器的初步介绍，另外一些 Zed 自带的比较好用的远程编辑文件、自带 Web 服务器等特性后面有空再来写了，大家也可以研究折腾甚至开发自己的 ZPM 包哦。文章中有任何问题还请提出指正，火热的六月仍然祝大家玩的开心呢 ^_^。

最近在 Raspberry Pi 编程时需要对文件进行十六进制编辑，原来一直用的 vim 配合 xxd 来实现的，但用起来还是各种不方便，在切换到 X11 界面时，想着能不能直接装个图形的编辑器来方便操作。

简单搜索之后发现 Linux 环境下好用的十六进制编辑器确实太少了，原来用的 Ghex 软件由于必须要 GNOME 环境支持果断放弃，UltraEdit 软件已经移植到 Linux 下，但由于是闭源的只有 X86 下的版本。装了这个 Bless Hex Editor 软件，是基于 Mono 实现的，但发现有一些非正常退出的 bug，还是弃用之。

最后发现的 wxHexEditor 看起来很不错，基于 wxWidgets 实现，因此实现了 Windows、Linux、Mac OS X 跨平台，而且速度也挺好，不会一下装载整个文件，这对编辑大文件非常有用，填补了 Linux 上缺少好的十六进制编辑器的空白，看看 Linux 上的运行截图：

想直接在线安装 wxHexEditor 发现有问题了，Raspberry Pi 的默认 Debian Wheezy 发行版中没有这个软件，需要自己来编译了，首先到其官网下载源代码包：http://www.wxhexeditor.org/。

首先 Raspberry Pi 需要相对完整点的开发环境，gcc、make、g++、autoconf、libtool 等一些开发工具包都是需要安装的。准备好之后使用 apt-get install libwxgtk2.8-dev 命令先在 Raspberry Pi 系统中安装 wxWidgets 的最新版本的库文件（自动依赖并安装）和开发包。然后进入解压缩出来的 wxHexEditor 源代码目录，运行 make OPTFLAGS="-fopenmp" 命令就可以进行编译，粗略估计编译需耗时 15 分钟左右（有点汗...）。

不想自己的编译的童鞋欢迎使用我编译好的版本哦，解压缩把 wxHexEditor 文件拷到 /usr/bin 之类的路径即可，要运行此程序最少要安装 wxWidgets 运行库哦（apt-get install libwxgtk2.8-0），需要注意此文件只在 Raspberry Pi 的 Debian Wheezy hardhf 版本系统中可用：

http://miseal.googlecode.com/files/wxHexEditor-v0.20.7z