# Markdown Viewer

Description from extension meta

## Markdown Viewer

Image from store
Description from store ✔ Renders local and remote URLs ✔ Granular access to remote origins ✔ Multiple markdown parsers ✔ Full control over the compiler options ✔ Themes (including GitHub theme) ✔ GitHub Flavored Markdown (GFM) ✔ Auto reload on file change ✔ Syntax highlighted code blocks ✔ Table of Contents (TOC) ✔ MathJax and Emoji support ✔ Mermaid diagrams support ✔ Remembers scroll position ✔ Markdown Content-Type detection ✔ URL detection using RegExp ✔ Toggle Content Security Policy (CSP) ✔ Override page encoding ✔ Settings synchronization ✔ Raw and rendered markdown views ✔ Free and Open Source ✚ Local Files 1. Navigate to chrome://extensions 2. Locate Markdown Viewer and click on the DETAILS button 3. Make sure that the Allow access to file URLs switch is turned on ✚ Remote Files 1. Click on the Markdown Viewer icon and select Advanced Options 2. Add the origin that you want enabled for the Markdown Viewer extension ✚ Compiler Options ✔ Compilers: Marked, Remark ✔ Documentation: https://github.com/simov/markdown-viewer#compiler-options ✚ Content Options ✔ Features: Autoreload, TOC, Mathjax, Emoji, Scroll ✔ Documentation: https://github.com/simov/markdown-viewer#content-options ✚ Full Documentation ✔ https://github.com/simov/markdown-viewer

### Latest reviews

• (2020-12-27) 南枫: 这个插件很牛逼，主要是因为代码在SVN上，所以特别需要这个插件，very nice
• (2020-12-05) Matthew Woo: This makes viewing markdown files so easy! I write my notes in markdown now and if I need to look at it I can just open in chrome
• (2020-11-22) Alex Wang: Any idea if you can improve it such that it can support LaTex mode such as the following? $$f(x) = x^2 + y^2$$ where $x$ is real part and $y$ is imaginary part.
• (2020-11-16) 星辰大海: I cannot use it on github like README.md.It doesn't work at all!
• (2020-11-05) joker K: 不错
• (2020-11-03) Enchic Gong: It reminds me of VuePress, but I don't know how it really works. This is incredible!
• (2020-11-02) Elivelton Vieira: Ótima extensão, ótimo CSS, compatibilidade, enfim, muito bom.
• (2020-10-08) Gabriel Staples: Produces nearly perfect markdown file output--almost identical to what GitHub shows for any given markdown file--images, formatting, tables, and all! I wrote about it in my answer here: https://superuser.com/a/1591372/425838.
• (2020-09-28) 陆金凯: 目录比较长的时候，显示不全
• (2020-09-18) Steven F: I installed this and for probably a week had trouble figuring out how to use it. If I opened files in google chrome it would just show them in plain text. However after some googling I discovered you have to allow access to local URLs, AND have file:///* enabled under sites. These options are only selectable on the extensions page and not from the plugin bar. There should be a note of this somewhere in the description. Otherwise I think this will meet my needs of previewing markdown documents.
• (2020-08-27) xiyou xier: 非常好用！
• (2020-08-25) Mars Dong: It doesnt work at all. still showing plain text
• (2020-08-22) Vikram Jadhav: Does what it says!
• (2020-08-13) Felix V: Nice job, I really like how many options you have. Bad thing: The only good theme (dark github) fills my html paddings with white color! For example when using this html to display an image in the center: <img src="./my_image.png" alt="drawing" width="600" style="padding-left:200px"/>
• (2020-08-11) xiaoxuan yu: 功能很棒，还可以选择不同的浏览方式
• (2020-07-31) cliff heath: 很棒！
• (2020-07-25) KristijanRoss: loving the simplicity
• (2020-07-24) Dean Arnold: Does not render Markdown (*.md files).
• (2020-07-13) Enrique Reyes: Não funciona no meu navegador (Versão 83.0.4103.106 (Versão oficial) 64 bits). Estou num Arch linux (5.7.7-arch1-1). A página md local aparece em uma caixa cinza mas sem conteúdo.
• (2020-07-11) Gregory Shields: Great work. The MARKDOWN-ALT theme has a very eye-catching rendering of text blocks surrounded by backticks (like this). It would definitely be nice to have one's own CSS and create custom themes to include highlighting features like this in other themes.
• (2020-07-11) Marcos Junior: Não funciona
• (2020-07-08) wsi lin: 可以使用的一款Markdown预览插件，缺点是网站原本的页面布局会变得混乱
• (2020-06-23) Bit0r Mack: 非常好用，和markbook的阅读体验一样
• (2020-04-06) JuanPablo Jofre: So far very good!! I need to review a bunch of technical documents (for software developers) and this little guy does it perfect. All formatting is neatly presented... and there's an ample amount of themes to choose how you'll see the document. Links work, as expected. I'll come back, to add further notes.
• (2020-04-05) Cezary Dołęga: Działa !
• (2020-03-28) xbeta Zhang: 小巧方便 体积小巧；文件更新后可自动刷新；支持换行（这一点非常重要）。样式很多，但缺少css自定义功能。
• (2020-03-26) Yuenshu Fong: How to save my markdown file to html file?
• (2020-03-22) Nico Alba: I've enabled allow access to file URLs, when I drop a .md file into Chrome, it just downloads the file instead of opening it...
• (2020-03-02) Chengfa Li: works with latest Chrome version 80. Love it.
• (2020-02-28) Bart N: Does not do anything when you open an .md file
• (2020-02-18) Soma Black: Muy útil y completa la extensión
• (2020-02-08) alphen liam: 非常棒，希望能够添加highlight支持
• (2020-01-21) NICK DUAN: 各种功能非常齐全，而且显示美观，希望继续支持一下自动刷线的功能
• (2020-01-19) Coco Mang: Does not work, the md files are seen as text files, no formating
• (2020-01-17) Patrick Grochowy: Just shows the markdown source-code. Not discernible for me, how to get it to show the rendered markdown (Chrome 79.0.3945.117 on Win10Pro). So it's useless ...
• (2020-01-05) Musa Haidari: There are some unique characteristics about this extension: 1. The compiler can read complex syntax. 2. You can choose your compiler. 3. You can choose your theme from a wide variety. 4. You have fine level control over the permissions you give it. 5. You have fine grained control on activating (or not) the individual features
• (2019-12-19) Tony Rambone: does not render any markdown from git repo I'm working on... followed the readme.md from git repository, Documentation: https://github.com/simov/markdown-viewer#table-of-contents. enabled the 'allow access to file:urls' in the advanced options' as instruction states... running, Chrome: 78.0.3904.97 (Official Build) (64-bit)
• (2019-12-17) PRIME GEEK: My markdown cannot display local picture(you can only see the title but cannot see picturs), i use google chrome, can anyone help me?
• (2019-11-26) Nylson Santos: Boa extensão
• (2019-11-20) Daniel Thornton: no work
• (2019-11-19) Jim Par: This is exactly what I needed, and it works wonderfully. I prefer to edit my MD files in a separate app, and view them in the browser. I haven't gotten to embedded images yet, but so far I like this better than Typora
• (2019-11-15) Tucker Miller: Love this so much, very clean
• (2019-11-04) Juan Miscaro: Doesn't work. How do you turn an md page into HTML? The conversion just appears in the video without any explanation. I've allowed local files. What do I need to do???
• (2019-11-04) Павел Рябов: I love the plug-in, really handy, brisk and with many themes. Unfortunately, I cannot figure out how to make Chrome stop downloading .md files instead of opening them as it did before.
• (2019-11-04) 雷雨: 直接用瀏覽器看markdown效果就靠它了,謝謝!
• (2019-11-04) Luke Ellison: Tried changing all the settings but just flat out did not work on my mac.
• (2019-10-11) co po: It loads a blank page when I visit this website https://github.com/ziishaned/learn-regex/blob/master/translations/README-cn.md
• (2019-09-30) Wexlei Silveira: I have no idea how to make this work for local files.
• (2019-08-17) 围城之外: 代码无法显示行号,在vscode中使用了java {class=line-numbers} ,可以显示行号,这个插件不行
• (2019-08-13) sword zen: 导航树点击不能跳转

### Latest issues

• (2021-01-06, v:4.0) Marie-Neige Chapel: Mermaid diagrams support
I try to add this simple mermaid diagram into my .md file : mermaid graph LR A --- B B-->C[fa:fa-ban forbidden] B-->D(fa:fa-spinner);  but it doesn't work. The text shows up but not the diagram.
• (2021-01-05, v:4.0) Mo G: Beginner: Read & Write or only Read?
Hey there, can you edit & write with your viewer, or literally only read rmd files? Thans a ton!
• (2020-12-31, v:4.0) Hao Deng: syntax highlighting for Q (kdb+)
The Q programming language, (kdb+ database) is supported by Prism, but not in the viewer, can you please add it? Thanks.
• (2020-12-08, v:3.9) Hugo Barthelemy: Doesn't works for Github
Doesn't works for Github. Try on : https://github.com/rails/rails/blob/master/README.md
• (2020-09-08, v:3.9) Colin Docherty: Auto file reload
The extension claims to have auto file reload. I'm writing out my md with vim, but it doesn't seem to be refreshing in my Chrome browser without an explicit refresh. Is there some option that needs to be enabled to get this working? I used to use the extension Markdown Preview Plus, which does refresh every second or so, but its nowhere as good as your extension.
• (2020-08-09, v:3.9) Lars Schiegl: Chrome still downloads .md files instead of opening
"Allow access to file URLs" is enabled and I tried both options under "Site Access" (<https://imgur.com/a/d1443rf> Which one is the actual right one anyway?) Nonetheless, I cannot open them. My current workaround is to change ".md" back to ".txt", but in the long term I will delete the extension if there is no solution for this issue.
• (2020-07-08, v:3.9) Facundo Chambo: Breaks GitHub webpage on .md files
It has some issues with GitHub .md files. If you need to reproduce it, just enable the extension and visit any repository that has a README.md file in its root directory.
• (2020-06-21, v:3.9) Robert Inder: Working with Emacs "impatient-mode"
The Emacs editor supports "impatient-mode", an add-on which runs a web server within Emacs, and generates web pages that update as you type text. I was hoping to use this with Markdown Viewer to get a continuously updating rendition of the markdown I am typing. But it doesn't work: I just see a (continuously updating) copy of the raw Markdown. I THINK I have understood the problem. Emacs's "impatient mode" serves the current state of the document within an iframe that is nested in an HTML "wrapper" document. That document has no meaningful content, so all the users sees is the content of the iframe. But the wrapper document does have some javascript which continually attempts to update the iFrame. I **THINK** the markdown being fetched from Emacs is not being rendered because when Markdown Viewer formats the web page, it does not go "into" the iframe, and Chrome does not invoke it on the content of the iframe, even though it comes from a URL that matches Viewer's targets. So what appears on the screen is just the raw Markdown, as it is loaded into the iframe. Does that make sense? Is it a plausible explanation of why the raw markdown is being displayed in a web page that Markdown Viewer is (meant to be) processing. If you think that that is likely to be the problem, I'll think about how I might be able to solve it!
• (2020-05-20, v:3.9) Holger Brandl: Extension breaks page rendering if url ends parameter with .md suffix
E.g. many github issue template links fail to render: https://github.com/portainer/portainer/issues/new?template=Feature_request.md
• (2020-05-11, v:3.9) Esteban Martin: Markdown local file is not visualized as Markdown.
Hi, I installed this extension and loaded a local file with name README.dist.md and the file is displayed as text format. I enabled both URL/File options in extension configuration. No errors in Chrome DevTools. Sorry foy me english. Thanks. Chrome Versión 81.0.4044.138 (Build oficial) (64 bits)
• (2020-05-11, v:3.9) Willis SONG: 文本颜色
可以支持设置文本颜色吗
• (2020-04-22, v:3.9) Refaat Yakoub: MathJax Configuration
Thanks for replying. I am using MathJax option, I just wanted to add the auto equation numbering. I know this is doable if we add this configuration lines: MathJax.Hub.Config({ TeX: { equationNumbers: { autoNumber: "AMS" } } Where in the viewer extension can this config be added? Thanks
• (2020-04-21, v:3.9) Refaat Yakoub: Equation number
Hi How to enable equations number and cross reference.
• (2020-04-02, v:3.9) Deepal Moon: Why can't I get your Markdown
I have ''Allow Access to File" turned on. Every time I try to open a markdown file, chrome just downloads it. If I try to open the downloaded file it opens in 'Markdown Monster'. Because that is the file type I have associated with *.md files. What do I need to do?
• (2020-01-21, v:3.8) Zdenek Valach: Content option scroll=false
Hi, I need to change default behavior of Markdown Viewer in Chrome store, when there is default value scroll=true, but I need to change it to scroll=false when I am linking MD files from external final and need use to address certains anchors in document using # syntax. How can I change this option ?
• (2020-01-13, v:3.8) Craig Williams: SaveAs HTML
Is there an option somewhere save the HTML for what is rendered? SaveAs and View Source only show me the raw markdown. Would be a nice addition if this is not possible.
• (2019-12-18, v:3.7) James Stevens: Just displays as plain text
Chrome Version 79.0.3945.79 (Official Build) (64-bit) on Ubuntu - I open the file in Chrome from the file manager. Chrome opens it fine, but displays it just like plain text - there is zero interpretation of the md, looks the same as in notepad.
• (2019-11-07, v:3.7) 赖凌锋: How to enable soft wraps？
How to enable soft wraps and resize image?
• (2019-10-10, v:3.7) Tony Barganski: Markdown Viewer no longer opens file:///<mardownfile.md>
"Allow access to file URLs" is enabled. Following Windows 10 updates and a possible Chrome update to version: "Version 77.0.3865.75 (Official Build) (64-bit)" Chrome now downloads the file instead. If I click on the downloaded file details at the bottom of Chrome window and and select "Always open..." this then only opens with the application associated with ".md" files in Windows.
• (2019-09-11, v:3.7) Soma Hargitai: Does not complie MD file on Mac/Chrome
After installation I tried to disable all the other extensions, but it still does not show properly my MD file. I use a company Mac machine Browser is Google Chrome MD file is in my local folder
• (2019-08-22, v:3.6) Alex Russell: Plugin incompatibilities
In addition to the Adobe Acrobat extension, I also found it won't work if Adblock or Google's Docs PDF/PowerPoint Viewer extensions are active.
• (2019-05-20, v:3.6) David Beckedorff: Preview Markdown file as HTML
Once I have loaded a local MD file into Chrome with your extension, what's the best way to preview the HTML version of the raw MD text/code? I'm running on a Windows 10 PC if it matters. I tried the Markdown Preview Plus extension but it doesn't do anything when I load an MD file. I guess your extension captures the file first.
• (2019-05-15, v:3.6) Vladimir Dyrdin: Link from article to subchapter doesn't work
for example we have two files: in main.md [link to other topic](topic.md#topic5) in topic.md #topic1 ... #topic5 Top of the subarticle opens but anchor tag does not link.
• (2019-05-11, v:3.6) M: As noted below, local file rendering for markdown (.md) doesn't work at all
As noted below, local file rendering for markdown (.md) doesn't work at all. I've carefully followed all of the instructions in the documentation. Nothing works. MacOS 10.14.4 ---- Google Chrome is up to date Version 74.0.3729.131 (Official Build) (64-bit) ---- Markdown Viewer 3.6 (newest version)
• (2019-05-08, v:3.6) Robert Douglas: JS in markdown file
Trying to create some living documentation using markdown that will run a script to get a table of data from my own server when MarkdownViewer renders my local file. I've put a script inside my markdown, but I see no evidence of it getting run when I load my file in chrome. All the rest of the markdown renders fine. Inspecting the page, I can see the script inside html/body/div(_html) but I do not see the initial console.log("Got here") ever fire. example markdown: # Test <script> console.log("Got here"); </script>
• (2019-04-28, v:3.6) Ville Valpasvuo: Empty cells in tables don't work
If I try to insert empty cell by just adding space between pipes, I don't get an empty cell but instead the second pipe is used as text in the next cell and two cells are collapsed. Unfortunately neither space or nonbreaking space doesn't make an empty cell appear, but luckily by adding byte order mark I am able to get an empty cell.
• (2019-04-04, v:3.6) emofdo: Multiple blank lines in code fenced blocks break inside lists
Multiple blank lines in code fenced blocks break inside lists Hello I'm experiencing some issues when using fenced code blocks inside lists. When the code block contains multiple consecutive blank lines, it will break. Some example data: https://pastebin.com/p5ZtabLL Corresponding screenshots: http://nl.tinypic.com/r/w9z5n5/9

### Statistics

Installs
143,970 history
Category
Rating
4.2 (255 votes)
Last update / version
2020-12-24 / 4.0
Listing languages