查看离线的Markdown文件

688

有没有一种方法可以离线显示.md文件,以便我们知道上传到Github后它的外观? 我指的是展示 README.md 文件,就像在Github中呈现的样子,而不是为编辑目的。

需要在Mac和Windows上工作,因为我都使用。

34个回答

20
你试过ReText吗?它是一个很好的桌面Markdown编辑器。

有这么多的依赖关系,但看起来还不错! - dmeu
可以在这里找到有关如何在Mac OS X上安装reText的一些信息:http://sourceforge.net/p/retext/wiki/Home/ - lauhub
1
你可能需要手动安装一些依赖项:sudo apt-get install python3-docutils python3-markdown - Konstantin Smolyanin
在Ubuntu 15.04中,一切都会自动配置好,包括依赖项和文件类型关联。 - colan
2
@Moytaba 看起来它已经迁移到 GitHub:https://github.com/retext-project/retext - NuclearPeon
显示剩余2条评论

14

我发现MarkView Google Chrome扩展程序非常有用,实际上它的效果很棒:

MarkView是一个Chrome扩展程序,可编辑和查看带有大纲视图的Markdown文件,支持多种表格格式样式、代码块语法高亮和Github Flavored Markdown。

功能:

  1. 以网页形式编辑和查看Markdown文件。
  2. 在更改文件时自动重新加载本地文件 (安装后:在chrome://extensions/中选择“允许访问文件URL”选项)
  3. 在内容旁边以可滚动的方式显示大纲。
  4. 拥有返回顶部、查看源代码和返回底部按钮。
  5. 支持Github Flavored Markdown表格样式和代码高亮。
  6. 为编程语言的代码区域添加高亮(例如 ```ruby)。
  7. 支持美观的网页打印(Chrome->文件->打印...)。
  8. 响应式设计:当窗口大小小于940px时,大纲部分将自动隐藏;调整为大于940px时,大纲部分将显示。
  9. MarkView将查看除raw.github.com下的所有Markdown文件,因为该子域仅显示源码。

MarkView还增加了更多功能:

  1. 所见即所得的Markdown编辑器
  2. 主题和代码样式选择
  3. 支持脚注1
  4. 即时幻灯片演示
  5. 文档自定义样式

    • 添加主题CSS并进行选择
    • 添加代码样式并进行选择
    • 编写CSS、保存并运行

13

我喜欢 Downmarker 中的垂直分割器,因为你可以在写作时看到更改!


11

Geany 有一个与 Markdown 相关的 插件,它可以很好地完成工作,并在侧边栏中给你提供 Markdown 预览。它还可以在 Linux、Mac OS X 和 Windows 上运行。

要使用它,首先安装 Geany,然后安装包 geany-plugin-markdown,并从插件管理器中选择它即可。


11
您可以使用texts作为Markdown查看器和编辑器,它轻巧且简洁。输入图像描述在此处

1
看起来不错,但安装程序有13MB,这让我想知道它都在安装什么。 - Brian
24
非免费:http://www.texts.io/purchase/ - TN.
5
不支持 Linux 系统。 - jameshfisher
4
我发现这会使许多md文件的呈现效果很差。 - Zv_oDD
2
在 Mac 上,它需要预先安装一些外部工具“fandoc”,我不了解也不信任它,尤其是它位于我的操作系统的某个位置。包装器本身(Texts)重约4MB,这对于一个 .md 渲染器来说太大了,甚至没有那个外部工具……总之,这不是一个令人印象深刻的应用程序。 - Motti Shneor
显示剩余2条评论

9
我刚刚使用node.js文件监视器和socket.io编写了一个离线markdown查看器,所以您可以将浏览器指向localhost并运行./markdownviewer /path/to/README.md,它将使用websockets将其流式传输到浏览器。

9

还有一个StackEdit。它既可以在线使用,也可以离线使用(它使用您的浏览器本地存储)。

您还可以将其连接到Dropbox或Google Drive,以查看托管在云上的文件。


4
浏览器存储非常有限,非常非常有限。 - Pacerier

8

如果您是vim用户,您可以尝试使用vim-preview插件。只需使用您选择的方法将其安装到~/.vim目录中即可。然后,您可以使用命令:Preview打开一个Markdown文件,在浏览器中打开新窗口并显示最终结果。


1
谢谢!不幸的是,该插件需要一个内置的Ruby解释器和一些Gem。对我来说依赖项太多了... - xverges
2
是的,对不起 - 我之前安装过它,所以忘记提到 Ruby Gems 的事情了(对于未来的读者:我上面包含的插件链接描述了如何解决这个问题,如果你对这种 Ruby 东西感兴趣的话)。 - Peter Diakumis
1
另一个使用JavaScript的Vim插件:https://github.com/suan/vim-instant-markdown - matiasg

7
考虑使用Strapdown
Strapdown是一种基于Javascript的解决方案,可以在浏览器中呈现Markdown内容,非常适合离线查看。根据他们自己的描述:

Strapdown.js使创建优雅的Markdown文档变得非常简单。无需服务器端编译。

因此,将您的.md Markdown文件重命名为.html并将其包围在以下标记中:
<xmp theme="united" style="display:none;">
# Markdown content here
…
</xmp>
<script src="http://strapdownjs.com/v/0.2/strapdown.js"></script>

而且在任何浏览器中打开都会显示渲染的HTML。额外的好处是:您可以轻松更改主题。


6

在MacOSX上,最简单易用的资源之一是Markdown Quick Look插件,可以在InkMark找到。安装后,在OS X 10.9+中,只需在Finder中选择一个Markdown文件,然后按空格键即可。我不确定结果是否与Github完全相关,但它们非常好,并且成为了一个小巧、不显眼的离线查看器解决方案。如果您想要其他选项,Mashable也写了一篇关于78种不同工具的文章。

Makrdown-QuickLook-Preview


网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接