Markdown Reader
English | 中文 | 한국어
https://md-reader.github.io
Markdown Reader is a powerful browser extension that enables you to conveniently preview Markdown documents in your browser.
This repository contains the old source code of Markdown Reader(2.x version) and is no longer maintained.
It is used only to collect issues about Markdown Reader.
Please download the 3.x version from the website.
- Document Formats: Preview links in
file://, http://, https:// and files with .md, .mkd, .mdx, .markdown extensions:
https://example.com/example.md (online Markdown URL)file:///Users/my-project/readme.markdown (local Markdown file, *requires specific permissions)
- Syntax Plugins: Emoji, superscripts/subscripts, checkboxes, math, flowcharts, Gantt charts, TOC, insertions, abbreviations, annotations, alerts.
- Themes: High quality light/dark themes and code highlighting.
- Hot Reloading: Real-time document changes and centered display for better reading.
- Document Organization: Sidebar directory, original content preview, and image media support.
- Shortcuts: Quick function invocation with web extension shortcuts.
The default theme styles are stored in https://github.com/md-reader/theme. If you’d like to view or customize the theme styles, feel free to visit the link and adjust the CSS files as needed.
Installation
A. Install from web extension Store
B. Building installation
Example of Chrome:
-
Clone the md-reader repository and build it:
# Clone this repository
git clone https://github.com/md-reader/md-reader.git && cd md-reader
# Install dependencies
pnpm install
# Build the extension
pnpm build
-
After a successful build, the md-reader/dist folder will contain the md-reader-xxx.zip extension package.
-
Go to the Extensions management page in Chrome and drag the extension into the browser to install it.
Usage
Example of Chrome:
After installation, Chrome is now able to preview online markdown documents. However, it is not able to preview local markdown documents by default and requires enabling file access permission for the Chrome extension.
Allowing File Access Permission
Due to security reasons, Chrome by default disables extension access to local files. Therefore, after installing the plugin, you need to manually enable the permission in order to preview local markdown files.
In the Chrome Extensions management page, locate the installed "Markdown Reader" extension, click on "Details", and find the option "Allow access to file URLs" in the details page. Switch it to the enabled state (Please rest assured that "Markdown Reader" only performs read and display operations on markdown files and will not modify or upload user file data).
Now all the work is done~!ヾ(◍°∇°◍)ﾉ
Try the effect by opening this online document: Example Document; You can also try dragging a Markdown document directly into the browser!
Feel free to ask any questions or provide suggestions.
Giving a star to show your support is also an encouragement for me~!
Join the WeChat Community
Scan the code to get the latest news and technical support:
License
License MIT
© 2018-present, Bener
