离线查看markdown文件[关闭]


609

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

我需要同时在Mac和Windows上运行。

Answers:


428

有一些Chrome插件运行良好。我一直在使用Markdown Preview Plus

安装后,在扩展程序中启用“允许访问文件URL”(菜单>更多工具>扩展名或输入URL chrome://extensions/)。

enter image description here

然后将Markdown文件拖放到Chrome上,然后使用您喜欢的编辑器进行编辑。


3
谢谢,Chrome扩展程序将永远有用;无需使用额外的软件
Avi 2013年

37
谢谢!已安装,无法弄清为什么无法正确渲染md文件-关键在于“允许访问...”。
mattezell 2013年

1
Markdown Preview不支持代码块
ACyclic 2015年

2
更具体地说,当Markdown Preview遇到```时,它将代码块中的所有行放在一行上。所以我尝试了swcool提到的Markview。样式与github并不完全匹配,但是至少将代码块中的每一行放在单独的行上。
EL Rayle 2015年

2
从Markdown Preview切换到Markdown Preview Plus,因为它可以修复代码块等。在上方编辑了我的答案以反映这一点。
吉姆·伯格曼

256

我前一段时间写《Grip》就是为了做到这一点。它的呈现与GitHub上的呈现完全相同,并且还提供了几个其他选项:

  • 除了自述文件外,Grip还可以呈现GitHub注释和问题
  • 单击本地链接以呈现其他.md文件
  • 在自己的项目中使用的API
  • 导出到HTML文件

用pip安装:

pip install grip

然后转到包含您的自述文件的目录并运行:

grip

通过-h以获取其他帮助和选项。

这是Grip渲染Grip自述文件的屏幕截图:

Screenshot of Grip rendering Grip

希望这可以帮助。在这里查看


2
@luchosrock您可以张贴Markdown的要领,以正确显示吗?如果有任何不匹配,我将提交一个错误并修复它。
2014年

2
@luchosrock我想您可能会混淆两者。从gfms自己的文档来看,“ GFMS的当前实现不会给源代码块加色”,而Grip却可以。Grip使用GitHub自己的Markdown API并开箱即用地设计样式,而不是自定义解决方案,这正是Grip如此精确的原因。另外,gfms是基于节点的,而不是Python。
2014年

2
与其他解决方案不同,在Linux上像魅力一样!谢谢!
akhmed 2015年

5
轻巧可爱。谢谢!
本杰明·R

2
@Joe自己发现了这个。做得好。做工精美。
idjaw 2016年

106

2
如果要编辑许多.md文件,这很好。即时预览,而无需切换到另一个应用程序总是一个加号。
dval,2015年

甚至还有一个自动滚动包:github.com/mark-hahn/markdown-scroll-sync。当前,您必须修补github.com/mark-hahn/markdown-scroll-sync/pull/66/files,以使其在没有警告的情况下工作。
Dror

1
这也是一个很好的建议。并排窗格的即时预览是一个奖励!无需保存并不断退出。
AnimNations

答案底部的链接不存在
xxx ---

64

Visual Studio Code -Microsoft的新编辑器还为markdown编辑提供了很好的支持。
您可以从这里下载。
编辑器提供了很好的支持,可以在降价代码预览模式之间切换。 它还为所有降价语法提供了相当不错的智能感知支持。 该编辑器可免费使用,并且可以跨平台使用(可在Linux,Windows和Mac上运行)。 有关更多详细信息,请访问他们的网站


enter image description here


2
真棒,最简单!
Mayur Patil

2
很好的建议。MS Visual Code是一种惊人的工具,可在许多不同的上下文中用于许多不同的事物。免费; 它可以在Windows,Linux和MacOS上运行。
paulsm4

1
太好了,我已经安装了一个解决方案!我有两个小问题要解决:要打开预览窗格,请右键单击顶部的文件选项卡,然后选择“打开预览(Ctrl?Shift + V)”。要调用@sundeep提到的智能感知,请在编辑器窗口中按Ctrl + Space。
理查兹,

3
ctrl + kv预览
-aderchox

62

晚会了,但是看看MarkdownPad


21
如果您想获得对github风格的markdown的支持,您必须获得MarkdownPad Pro-售价约15美元。我个人可能会为此支付5美元,但肯定不会支付15美元。因此,如果有人可以推荐其他东西,请这样做。
burzum

4
刚刚花了15美元购买了专业版,恕我直言,但如果它在Mono下运行,那就太好了,这样我就可以在linux / osx中使用它了,这是我这些天更多的开发方向。
Tracker1 2013年

MarkdownPad似乎在不久前进入封存制,所以我(披露警告:是的,我制造并出售了此产品)制造了MarkUpDown,但在15美元的价格上还不算过分。应该是GitHub Markdown友好的,如果不是,请告诉我它不是&我将其修复。
鲁芬

37

参见Python-Markdown-Editor

它基于:

  • Python降价
  • Pygments(突出显示代码块语法)
  • CodeMirror(JavaScript代码编辑器)
  • 瓶子

用pip安装:

$ pip install markdown-editor 

它具有键入时预览,代码突出显示,受限制的代码块,github样式的功能

它可以被命令行使用:

$ markdown_edit 

$ markdown_edit README.md

$ markdown_edit -f readme.html README.md

enter image description here

我创建此程序是为了构建用于发送代码评论的工具,该工具易于扩展,通过将其导入为模块可以添加自定义操作。


您好,这似乎是一个很棒的应用程序,但是我不能同时打开两个.md文件,因为大多数时候我只希望它成为查看器而不是编辑器。您是否可以使用localhost:8000 / <path / to / file.md > 这样的语法扩展它,使其能够查看多个.md文件?
arcticfox

您可以编辑多个文件-p <port>选项
尼古拉斯·科尔内特

给我一个回溯错误
Aderchox

29

我刚刚安装了https://github.com/ypocat/gfms。它很好地呈现了github风格的markdown。它可以检测到Markdown的变化,因此您只需将浏览器和编辑器并排放置即可。它是Node.js,因此在任何平台上都可以正常工作。

如果已安装Node.js,则安装很简单:

  1. sudo npm install -g gfms
  2. gfms --port 9999 (在您的项目目录中)
  3. http://localhost:9999/ (在任何浏览器中打开)

不幸的是,gfms没有像GFM那样呈现换行符-当段落中有单个换行符时,它不会插入<br>。但是对于“纯” Markdown渲染,这很好。
艾德·鲁德

2
gfms的更新版本(github.com/pawel-wiejacha/gfms)使用更好的GFM Markdown后端(已标记)并正确插入换行符。它还具有改进的目录列表和PDF导出功能。
Pawel Wiejacha 2014年

5
我尝试了此操作,因为它听起来很有希望。必须安装node.js(预期),但也要安装python。当它想要一个完整的C ++开发人员工具链时,我放弃了。因此,取决于您的平台,这可能很容易,但是如果您使用Windows,则甚至不要尝试此建议。
Chase

在Windows上几乎没有用NodeJS编写的内容。当“安装此软件”指南以“ npm install”开头时,我已经学到了难以解决的难题。NodeJS不像开发人员希望的那样跨平台。Golang和Python同样不好,但不如Node差。据我所知,唯一的脚本语言真正是跨平台的,可以在任何地方以最小的工作量运行,并且不需要安装数百MB的垃圾邮件,而PHP是。PHP CLI是一个隐藏的瑰宝-作为命令行脚本语言,它比其他任何语言都更好。
CubicleSoft '18

27

我找到了一种在PHP中查看它的方法。经过更多侦听之后,我发现了两种用于脱机和在线查看.md文件的解决方案:

我建议使用脱机版本,这样即使在宝座上进行业务时也可以进行编辑。:)


1
还有很多用于查看.md文件的桌面应用程序。
马特·鲍尔

我不知道 这些是什么?
2012年


@enchance,为什么要使用PHP?一个javascript版本会更好。
和平者

23

有人不使用谷歌浏览器。有一个名为Markdown Viewer的Firefox加载项,它可以脱机读取Markdown文件。


1
很好,这是WebExtensions的新链接(ff 57+)。
山姆

我想念什么吗?它说:“当前不支持file:// URL!” -难道没有资格取消解决方案吗?而且,许多一星级评论说Webext不能正常工作。
米奇

19

您是否尝试过ReText?这是一个不错的桌面Markdown编辑器


如此多的依赖关系。但是看起来还不错!
dmeu 2013年

有关如何在Mac OS X上安装reText的一些信息,可在此处
lauhub 2014年

1
您可能需要为此手动安装一些依赖项:sudo apt-get install python3-docutils python3-markdown
Konstantin Smolyanin

一切都将在Ubuntu 15.04中自动设置,包括相关性和mime类型关联。
科兰2015年

1
@Moytaba似乎已移至github:github.com/retext-project/retext
NuclearPeon,

17

pandoc是一个很好的“文本到文本”转换工具,可以解决Markdown的离线可视化问题。只是发出:

pandoc -f markdown -t html README.md > README.html

刚刚安装了它,并在几个文件上使用了它。很棒!
爱德华

14

我发现MarkView Google Chrome扩展程序非常有用,实际上它的工作就像一个魅力:

MarkView是Chrome扩展程序,用于编辑和查看带有轮廓视图的markdown文件,支持多种表格格式样式,代码块语法突出显示和Github风味Markdown。

特征:

  1. 以网页样式编辑和查看markdown文件。
  2. 更改文件后自动重新加载本地文件(安装后:在chrome:// extensions /中选择“允许访问文件URL”选项
  3. 以滚动方式在内容旁边显示大纲
  4. 有用于GoTop,ViewSource和GoBottom的按钮
  5. 支持Github Flavored Markdown表样式和代码突出显示。
  6. 突出显示用于编程语言的代码区域(例如,“ ruby​​”
  7. 支持外观良好的网页打印(Chrome->文件->打印...)
  8. 自适应:当窗口尺寸小于940px时,轮廓部分将自动隐藏;调整大小大于940px,将显示轮廓部分。
  9. MarkView将查看除raw.github.com下的所有markdown文件,因为该子域仅显示源。

更多功能已添加到MarkView:

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

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

@swcool如果您认为自己有更好的答案,请创建自己的答案,而不要编辑其他人。
2014年

我相信@swcool是上述Chrome扩展程序的作者,他只是在更新它吗?
mariomaric 2014年

是的,我是该Chrome扩展程序的作者。每当扩展添加了更多新功能时,我都希望更新上面的描述。这样可以将MarkView留在一个问题中的一个答案位置。是的,仅更新。但是似乎Stackoverflow系统未批准我的更新,因此我必须停止。@Jason
swcool 2014年


11

您可以将文本用作md查看器和md编辑器,它轻巧简洁。 在此处输入图片说明


1
这是一位高质量的编辑,感谢您的注意!
Lea Hayes

23
不免费:texts.io/purchase
TN。

4
也不适用于Linux。
jameshfisher 2014年

4
我发现这使许多md文件表现得很差。
Zv_oDD 2014年

2
在Mac上,它需要预安装一些我不知道或不信任的外部工具“ fandoc”,尤其是它位于我的操作系统中。包装器本身(文本)的重量约为4MB,对于.md渲染器而言,这太大了,即使没有该外部工具,也是如此。
Motti Shneor '16

11

Geany有一个Markdown 插件 Markdown,可以很好地完成工作,在侧边栏中也可以为您提供Markdown预览。它还可以在Linux,Mac OS X和Windows上运行。

要使用它,请安装geany,然后安装geany-plugin-markdown软件包并从插件管理器中选择它。


我所有人都用geany,这是我所期待的答案:)
Rutrus 16-4-24

9

我只是使用node.js文件监视程序和socket.io编写了一个脱机markdown查看器,因此您将浏览器指向localhost并运行./markdownviewer /path/to/README.md,然后使用websocket将其流式传输到浏览器。


整齐。到目前为止,我一直拒绝使用node.js,但想对其进行检查,这是一个很好的理由。样式不是完美的,也许查看器应该插入缺少的github css文件?
pduey 2013年

8

还有StackEdit。它可以在线和离线使用(使用您的浏览器本地存储)。

您还可以将其与Dropbox或Google云端硬盘连接,以查看托管在云端的文件。


4
浏览器的存储空间非常有限。非常非常有限。
Pacerier,2015年

8

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


谢谢!不幸的是,该插件需要内置的红宝石解释器和一些宝石。对我来说太多依赖...
xverges 2015年

1
是的,对此感到抱歉-我已经安装了一段时间,所以忘了提到ruby宝石(供以后的读者使用:我上面包含的插件链接描述了如果您喜欢这种ruby东西,该如何解决) 。
Peter Diakumis 2015年

1
另一个vim插件,这个使用javascript:github.com/suan/vim-instant-markdown
matiasg 2015年

7

考虑捷径

Strapdown是基于Javascript的解决方案,可在浏览器中呈现markdown内容,非常适合离线查看。从他们自己的描述:

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

因此,将您的.mdmarkdown文件重命名为.html,并将其括起来:

<xmp theme="united" style="display:none;">
# Markdown content here
…
</xmp>
<script src="http://strapdownjs.com/v/0.2/strapdown.js"></script>

并且在任何浏览器中打开将显示渲染的HTML。增加的好处:您可以轻松更改主题。


5

对于MAC,我使用Marked;对于Windows,我使用Muto-Mark。两者都支持GH样式表。


+1:我在Windows上使用MutoMark:1.非常轻巧(395KB)2.不错的查看器3.搜索功能(Ctr + F)4.高亮显示所有搜索结果
Iman Mahmoudinasab 2013年

1
可悲的是,它似乎不支持文件关联
draeron'1

4

对于OS X,Mou非常好,它带有两个GitHub CSS主题。


不错,但越野车。例如,删除标题标记###,但是所见即所得部分仍将其显示为标题。依此类推,我想我在使用它的2分钟内发现了3或4个错误。
mojuba 2014年

4

看看Haroopad。这是一个非常不错的#markdown编辑器。它是免费的,可用于多个平台。我已经在Mac OSX上尝试过了。


对许多所见即所得编辑的评论得出结论,Haroopad是最好的。它也适用于Windows和Mac。我只是下载它来编辑GitHub项目Wiki,到目前为止看起来还不错。
TonyG

4

在MacOSX上运行最简单的资源之一是InkMark上的Markdown Quick Look插件。在OS X 10.9+上安装此文件后,您只需在Finder中选择一个markdown文件并点击空格键。我不确定结果是否与Github有100%的相关性,但它们是否很好,是否可以成为一种小型,不引人注意的离线查看器解决方案。如果您需要其他选择,Mashable还写了一篇有关78种不同工具的文章。

Makrdown-QuickLook-预览


1
有史以来最好的。我可以算一下选择一个.md文件并命中空格的次数,只是为了给一点点诅咒-几百个,甚至几千个。然后,我会“和‘与牟开’,等待,关闭编辑侧-因为并排侧预览由编辑和只是在刚读取.MD文件nuisence。
Motti Shneor

4

在大多数情况下,简单的解决方案是:将降价标记复制/粘贴到“云”中的查看器中。这里有两个选择:

  1. Dillinger.io
  2. ing

没有安装!跨平台!跨浏览器!始终可用!

缺点:对于大文件,标准的云应用程序安全性问题可能会麻烦。


而且,当然,您甚至可以与全世界分享您的预发布文档,甚至无法证明它们……
Motti Shneor



2

RStudio可以处理markdown文件并将其转换为html和pdf。如果已经拥有它,则可以使用RStudio(这是R编程语言的IDE)。它是免费和开源的,并且可以在Windows,Mac和Linux上运行。


1

您可以使用Scribefire Next。

这是Mozilla Firefox浏览器插件。只需安装扩展程序并启动Firefox。自定义您的工具栏,然后将Scribefire快捷方式放置到该工具栏上。而且,由于它是浏览器插件,因此您可以在Mac,Linux和Windows中使用它。

当您想以Markdown模式书写时,只需Edit Code从Scribefire窗口中单击即可。

现在可以满足您的目的,进入Edit Code模式并复制所有文本,然后将其粘贴到.md文件中并上传。

没有实时预览功能,您必须切换Edit CodeEdit Visually预览文本。

我在Linux Mint框中使用它:

在此处输入图片说明

在此处输入图片说明

更新:

2014年,这里需要为其他读者和研究人员添加一些其他了不起的工具。刚刚使用过的Brackets + Markdown预览扩展


我爱括号!!!没有垃圾邮件,我确实做到了
a7omiton 2015年


By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.