如何在本地预览 Markdown Wiki?

How can I locally preview a Markdown Wiki?

Bitbucket 的 Wiki 使用 Markdown 语法。

有很多方法可以预览单个 .md 文件,但是有没有办法在 OS X 下预览整个 markdown 站点? IE。可以同时处理 多个文件的东西,内部链接有效

搜索它只会为单个文件生成数十个解决方案,但none 显然 应该适用于此设置。

您可能想要 "static site generator"(请参阅 few lists here). Their primary function it to walk a directory and convert all the files within to HTML. You can "build" the site and then browse the files on your filesystem, or many tools also offer a "serve" command which will serve the files on localhost for previewing. For example, Github uses Jekyll for some parts of their service (GitHub Pages)。

但是,我不知道 Bitbucket 使用的是哪些工具,所以我无法指出任何更具体的东西,它们会给您带来与 Bitbucket 的 Wiki 几乎相同的行为。我相信它们是一个 Python 商店(GitHub 是 Ruby——因此是一个 Ruby 工具),但是有多个 Python Markdown 解析器的实现,因此不会让你一直到那里。

此外,一些静态站点生成器是博客工具(按日期在有序列表中生成帖子)而其他则不是(生成静态页面,通常作为文档)。如果您想复制 Wiki,您可能需要一个文档生成器。

我有过 Pelican(博客引擎)和 MkDocs(文档生成器)的个人经验,但不知道是否能很好地满足您的需求(它们都出现在上面链接的列表中)。此外,这个答案已经危险地接近 opinion/software 推荐,所以我就到此为止了。

自从这个问题发布后,许多降价编辑器如雨后​​春笋般涌现,允许在本地浏览和编辑降价维基。 Obsidian and Typora 是其中的一些。