【发布时间】：2012-04-08 06:33:34
【问题描述】：
有没有办法离线显示.md 文件，以便我们知道它在 Github 中上传后的样子？我指的是在 Github 中显示 README.md 文件，而不是出于编辑目的。
需要在 Mac 和 Windows 上工作，因为我同时使用两者。
【问题讨论】：
【发布时间】：2012-04-08 06:33:34
【问题描述】：
了不起，当然是一个很棒的工具。
注意：不适用于 Mac
特点：
- 实时预览
- 免费。
- 极其轻巧
- 导出为 HTML、PDF
下载：https://remarkableapp.github.io/
编辑 2022
我现在使用并喜欢 Mark Text。 (https://marktext.app)
【讨论】：
-
仅适用于 Linux。 Windows 版本正在开发中。
-
不是真正的“跨”平台。仅限 Linux 和 Windows - 没有 Mac。
-
不管怎样，我在 Mac 上使用 Mark Text，这是我发现的最接近普通查看器的东西。
-
Mark Text 看起来很有前途，我希望它比目前提到的其他解决方案更好。但是，我还没有尝试过，因为下载是 149 MB（！）。这对于一个简单的编辑器来说有点沉重。不是我关心空间消耗，而是它会安装什么生态系统/底层软件堆栈？如果是Java之类的，我不会尝试。
Atom 来自 Github。为您提供并排预览。
【讨论】：
-
如果您正在编辑许多 .md 文件，这很好。即时预览，无需切换到另一个应用程序总是一个优点。
-
甚至还有一个自动滚动包：github.com/mark-hahn/markdown-scroll-sync。目前，您必须修补 github.com/mark-hahn/markdown-scroll-sync/pull/66/files 才能使其正常工作而不会出现警告。
-
这也是一个很好的建议。带有并排窗格的即时预览是一个奖励！无需经常保存和标签。
-
在 Atom 中，"Packages -> Markdown Preview -> Toggle Preview" 以实际查看呈现的文档
有些人不使用谷歌浏览器。有一个名为 Markdown Viewer 的 Firefox 插件可以离线读取 Markdown 文件。
【讨论】：
Geany 有一个 plugin for markdown，它做得很好，在侧边栏中还为您提供 Markdown 预览。它还可以在 Linux、Mac OS X 和 Windows 上运行。
要使用它，请安装 geany，然后安装包 geany-plugin-markdown 并从插件管理器中选择它。
【讨论】：
有一些 Chrome 插件运行良好。我一直在使用Markdown Preview Plus。
安装后，在扩展中启用“允许访问文件 URL”（菜单 > 更多工具 > 扩展或输入 URL chrome://extensions/）。
然后将 Markdown 文件拖放到 Chrome 上并使用您喜欢的编辑器进行编辑。
【讨论】：
它基于：
- Python-Markdown
- Pygments（代码块语法高亮）
- CodeMirror（javascript 代码编辑器）
- 瓶
使用 pip 安装：
$ pip install markdown-editor
它具有键入时预览、代码突出显示、围栏代码块、github 样式
它可以通过命令行使用：
$ markdown_edit
$ markdown_edit README.md
$ markdown_edit -f readme.html README.md
我创建它是为了构建一个用于发送代码审查的工具，它很容易扩展，通过将其作为模块导入，您可以添加自定义操作。
【讨论】：
-
你好，这似乎是一个很棒的应用程序，但是我不能同时打开两个 .md 文件，因为大多数时候我只是希望它是一个查看器而不是编辑器。你会用localhost:8000/<path/to/file.md>这样的语法来扩展它，让它能够查看多个.md文件吗？
-
您可以使用
-p <port>选项编辑多个文件 -
给我一个 Traceback 错误
-
有效，但您需要检查最新的问题 w.r.t 版本的 Python-Markdown 是必需的。例如此报告“使用 pip 安装安装正常，但从命令行启动编辑器时会引发以下错误：ModuleNotFoundError: No module named 'pymdownx.extrarawhtml' Uninstalling pymdown-extensions and reinstalling a previous version eg pymdown-extensions== 7.0 为我解决了这个问题。发生这种情况是因为安装要求是 pymdown-extensions>=2.0，但可以通过指定确切的版本来快速修复。”
仅供参考，Calibre 电子书查看器在解析 Markdown 文件并显示它们方面做得很好。
安装 calibre 后，只需 ebook-viewer myfile.md。
【讨论】：
适用于大多数情况的简单解决方案：将 markdown 复制/粘贴到“云”中的查看器中。这里有两个选择：
无需安装！跨平台！跨浏览器！随时可用！
缺点：大文件可能很麻烦，标准云应用程序安全问题。
【讨论】：
-
而且，当然，您正在与全世界共享您的预发布文档，甚至在能够证明它们之前......
RStudio可以处理markdown文件并将其转换为html和pdf。如果您已经拥有它，您可以使用 RStudio（它是 R 编程语言的 IDE）。它是免费和开源的，可在 Windows、Mac 和 Linux 上运行。
【讨论】：
我经常想要便携式应用程序。为此，我发现
http://cloose.github.io/CuteMarkEd/（我只是简单地尝试了一下，它似乎工作正常）。
【讨论】：
-
实际上看起来很麻烦
-
我使用的是 0.11.3，它对我来说很好用...
【讨论】：
-
酷，我已经安装了一个解决方案！我有两件小事要弄清楚：要打开预览窗格，请右键单击顶部的文件选项卡，然后选择“打开预览 (Ctrl?Shift+V)”。要调用 @sundeep 提到的智能感知，请在编辑器窗口中按 Ctrl+Space。
-
ctrl+k v 预览
-
如果有人对 macOS 组合感到困惑，那就是 Cmd + Shift + v
您可以使用易于安装和使用的 Firefox Markdown Viewer 插件。
【讨论】：
从现在开始我使用http://marxi.co/。 Marxi.co 有线上和线下版本。
【讨论】：
如果你是 vim 人，你可以试试 vim-preview 插件。只需使用您选择的方法将其安装到您的~/.vim 目录中。然后你可以用 vim 打开一个 Markdown 文件并使用命令:Preview 这将在你的浏览器中打开一个新窗口并显示最终结果。
【讨论】：
-
谢谢！不幸的是，该插件需要一个内置的 ruby 解释器和一些 gem。对我来说依赖太多了...
-
是的，很抱歉 - 我之前安装了它，所以忘了提及 ruby gems（对于未来的读者：我上面包含的插件链接描述了如果你'重新进入那种红宝石的东西）。
-
另一个vim插件，这个使用javascript：github.com/suan/vim-instant-markdown
用于 Visual Studio 的流行 Web Essentials 插件提供了 Markdown 查看器和编辑器。还支持Github语言语法添加代码sn-ps。
【讨论】：
我不久前写了Grip 就是为了做到这一点。它像在 GitHub 上一样完全呈现，并且还提供了几个额外的选项：
- 除了 README 之外，Grip 还可以呈现 GitHub cmets 和问题
- 单击本地链接以呈现其他 .md 文件
- 在您自己的项目中使用的 API
- 导出为 HTML 文件
使用 pip 安装：
pip install grip
然后转到包含您的 README 文件的目录并运行：
grip
通过-h 获取更多帮助和选项。
这是 Grip 渲染 Grip 的 README 的屏幕截图：
希望这会有所帮助。 Check it out here.
【讨论】：
-
它实际上非常有用，但它的渲染方式并不完全像 github（例如原始 html、一些语法高亮等）。我发现gfms 解决方案（基于python）可以很好地完成工作。
-
@luchosrock 你能发布一个不能正确渲染的 Markdown 要点吗？如果有任何不匹配，那么我会提交一个错误并修复它。
-
@luchosrock 我想你可能会混淆这两者。从 gfms 自己的文档中，“GFMS 的当前实现不会对源代码块着色”，而 Grip 会。 Grip 使用 GitHub 自己的 Markdown API 和开箱即用的样式，而不是自定义解决方案，这正是 Grip 如此准确的原因。此外，gfms 是基于 node 的，而不是 Python。
-
与其他解决方案不同，它在 Linux 上的工作就像一个魅力！谢谢！
-
这是一个有用的工具，但它似乎使用 GitHub 的 API 在浏览器中实际呈现页面。当我刷新页面超过 30 次时，我收到“已达到 GitHub 速率限制”错误。 Grip 似乎不支持离线观看。
您可以为 Notepad++ 使用名为 Markdown Syntax Highlighting 的扩展名。可以在 Github 上找到
安装后，会出现语言下拉菜单中的新选项
【讨论】：
-
令人兴奋。可以加个 Github 的链接吗？
-
这没有回答问题。目标是显示最终结果，而不是来源。
接下来您可以使用 Scribefire。
这是一个 Mozilla Firefox 浏览器插件。只需安装扩展程序并启动 Firefox。自定义您的工具栏并将 Scribefire 快捷方式放置到它。而且由于它是一个浏览器插件，你可以在 Mac、Linux 和 Windows 中使用它。
当您想在 Markdown 模式下书写时，只需在 Scribefire 窗口中单击 Edit Code。
现在为了达到您的目的，进入Edit Code模式并复制所有文本并将其粘贴到您的.md文件并上传。
没有实时预览功能，您必须切换Edit Code 和Edit Visually 来预览您的文本。
我在我的 Linux Mint 盒子中使用它：
更新：
现在是 2014 年，需要在这里为其他读者和研究人员添加一些其他很棒的工具。最近刚用Brackets+Markdown Preview Extension。
【讨论】：
pandoc 是一款不错的 Text-To-Text 转换工具，解决了 Markdown 离线可视化的问题。只需发出：
pandoc -f markdown -t html README.md > README.html
【讨论】：
这个 php 查看器带有响应式支持和许多自定义选项。
【讨论】：
查看Haroopad。这是一个非常好的#markdown 编辑器。它是免费的，可用于多个平台。我已经在 Mac OSX 上试过了。
【讨论】：
我刚刚安装了https://github.com/ypocat/gfms。它在渲染 github 风格的降价方面做得非常好。它会检测您的降价更改，因此您只需将浏览器和编辑器并排放置。它是 Node.js，因此它应该可以在任何平台上正常工作。
如果你已经安装了 Node.js，安装很简单：
sudo npm install -g gfms-
gfms --port 9999（在您的项目目录中） -
http://localhost:9999/（用任何浏览器打开）
【讨论】：
-
不幸的是，
gfms不会像 GFM 那样呈现换行符——它不会像 GFM 那样在段落内有单个换行符时插入
。但是对于“纯”的 Markdown 渲染来说，就可以了。 -
gfms (github.com/pawel-wiejacha/gfms) 的更新版本使用更好的 GFM Markdown 后端（已标记）并正确插入换行符。它还改进了目录列表和 PDF 导出功能。
-
我尝试了这个，因为它听起来很有希望。必须安装 node.js（预期）但也安装 python。当它想要一个完整的 C++ 开发人员工具链时，我放弃了。因此，根据您的平台，这可能很容易，但如果您在 Windows 上，甚至不要尝试这个建议。
-
几乎所有用 NodeJS 编写的东西都不能在 Windows 上运行。当“安装此软件”指南以“npm install”开头时，我已经学会了离开的艰难方法。 NodeJS 并不像开发人员希望人们相信的那样跨平台。 Golang 和 Python 也同样糟糕，但没有 Node.js 糟糕。我所知道的唯一一种真正跨平台的脚本语言，可以在任何地方以最小的努力工作，并且不需要安装数百 MB 的垃圾文件是 PHP。 PHP CLI 是一个隐藏的宝石——它作为一种命令行脚本语言比其他任何东西都好。
我发现MarkView Google Chrome extension 非常有用，实际上它就像一个魅力：
MarkView 是一个 Chrome 扩展，用于编辑和查看带有大纲视图的 markdown 文件，支持多种表格格式样式、代码块语法高亮和 Github Flavored Markdown。
特点：
- 以网页样式编辑和查看markdown文件。
- 文件更改时自动重新加载本地文件（安装后： 在 chrome://extensions/ 中选择“允许访问文件 URL”选项）
- 以可滚动的方式在内容旁边显示轮廓
- 拥有 GoTop、ViewSource 和 GoBottom 按钮
- 支持 Github Flavored Markdown 表格样式和代码高亮显示。
- 突出显示编程语言的代码区域（例如```ruby）
- 支持具有良好外观的网页打印（Chrome->文件->打印...）
- 响应式：当窗口尺寸小于 940px 时，轮廓部分会 自动隐藏；调整大小大于 940 像素，将显示轮廓部分。
- MarkView 将查看除 raw.github.com 下的所有 markdown 文件 因为该子域仅显示来源。
MarkView 添加了更多功能：
- 所见即所得的降价编辑器
- 主题和代码样式选择
- 支持脚注1↩
- 即时幻灯片演示
-
文档自定义样式
- 添加主题 CSS 并选择
- 添加代码样式并选择
- 编写 CSS，保存并运行
【讨论】：
还有StackEdit。它可以在线和离线工作（它使用您的浏览器本地存储）。
您还可以将其与 Dropbox 或 Google Drive 连接以查看托管在云上的文件。
【讨论】：
-
浏览器存储空间非常有限。非常非常有限。
对于 OS X，Mou 非常好用，它带有两个 GitHub CSS 主题。
【讨论】：
-
不错但有问题。例如。您删除标题标记###，但所见即所得部分仍将其显示为标题。以此类推，我想我在使用它的 2 分钟内发现了大约 3 或 4 个错误。
考虑Strapdown。
Strapdown 是基于 Javascript 的解决方案，可在浏览器中呈现 markdown 内容，非常适合离线查看。 来自他们自己的描述：
Strapdown.js 让创建优雅的 Markdown 文档变得非常简单。无需服务器端编译。
因此，将您的 .md 降价文件重命名为 .html，并用：
<xmp theme="united" style="display:none;">
# Markdown content here
…
</xmp>
<script src="http://strapdownjs.com/v/0.2/strapdown.js"></script>
在任何浏览器中打开都会显示呈现的 HTML。额外的好处：您可以轻松更改主题。
【讨论】：
聚会迟到了，但看看MarkdownPad。
【讨论】：
-
如果你想获得对 github 风格的降价的支持，你必须获得 MarkdownPad Pro - 大约 15 美元。我个人可能会为此支付 5 美元，但肯定不是 15 美元。因此，如果有人可以推荐其他东西，请这样做。
-
刚刚为专业版支付了 15 美元，恕我直言，物有所值，但如果它在 Mono 下运行会很好，这样我就可以在 linux/osx 中使用它，这是我的更多开发人员正在开发的地方天。
-
MarkdownPad 似乎不久前进入了后备箱，所以我（披露警告：是的，我制作并出售了这个）制作了MarkUpDown，这在 15 美元的价格并不算太破旧。应该是 GitHub Markdown 友好的，如果不是，请告诉我它是怎么回事，我会修复它。
您可以将texts 用作md 查看器和md 编辑器，它轻巧而整洁。
【讨论】：
-
看起来不错，但安装程序是 13mb，这让我想知道它在安装什么。
-
不是免费的：texts.io/purchase
-
也不适用于 Linux。
-
我发现这对许多 md 文件的渲染效果很差。
-
在 Mac 上，它需要预先安装一些我不知道或不信任的外部工具“fandoc”，尤其是它位于我的操作系统中的某个位置。包装器本身（文本）重约 4MB，对于 .md 渲染器来说太大了，即使没有那个外部工具......好吧，不是那么令人印象深刻的应用程序。