Renders mermaid diagrams inline in markdown documents hosted on github.com.
mercat Extension
Using Mermaid over images of your diagrams (png, jpg, etc.) in your markdown documents has the advantage that you can easily review any changes that are made to the diagram; they will appear as any other diff in your PRs. However, the problem is that the GitHub Flavored Markdown will not render your diagram. This kind of defeats the purpose of using Mermaid.
This extension solves that dilemma by scanning your markdown documents for Mermaid code blocks and replacing them with the actual diagrams. So you can keep reaping the benefits from diagrams-as-code yet get beautiful rendered diagrams when you read and share your markdown document on Github.
Etymology of the word Mer•cat:
It is a portmanteau of the words \"Mermaid\" and \"OctoCat\", the Github mascot. It sounds a bit like \"meerkat\", so that's what I call it and that's what the logo comes from.
Source Manifest.json
How to download and manually install mercat extension for Chrome
Looking for a way to install mercat extensions for Chrome, you can search for them in the Chrome Web Store, clicking the "Add to Chrome" button, and following the straightforward process.
However, you may need to install mercat extensions manually, this article outlines two simple methods to effortlessly install mercat extensions, whether they come as unpacked folders in compressed formats like .zip or as .crx files.
Method 1: Download mercat extension and manually install through Drag &Drop
If you ever need to manually install a mercat extension for Chrome, don't worry, it's a simple process. Just follow these easy steps, and you will have your extension ready to use in no time.
Step 1: Download the mercat Extension by clicking the "Download CRX" button on the website.
Look for the mercat extension you wish to install. Go to the website and download the mercat extension package, which is usually a .CRX file and comes in a zipped file. Here ".crx" file is the format for mercat extension that contains all the data.
Step 2: Extract &Arrange Files
Once the file is downloaded, extract that file into its own folder. Similarly, give that extension files a permanent home. In other words, keep it in a folder that you don't accidentally delete it because these files will be needed to make that extension work.
Step 3: Go to the Chrome Extensions Page
Open Google Chrome and in the address bar, type chrome://extensions; it will open the Google Chrome extensions page. Make sure that "My extensions" is selected in the sidebar.
Step 4: Drag and Drop the Extension
Now, go to the folder where you extracted the mercat extension and drag &drop the extension file from there anywhere onto the extension page within Google Chrome.
Step 5: Complete the Installation
Once you drag and drop the extension file, follow the steps that Google Chrome takes you through. Similarly, if the extension file is of .crx file format, you will be required to review the permissions and then add the extension.
Now, you can manage that added extension as you would like to with any other Chrome extension that you added through Chrome Webstore. Its icon will also appear in the Google Chrome Menu on the right side of the address bar once you activate it.
Method 2: Download mercat extension for Chrome and install in Developer Mode
This is another method to install mercat extension manually, but the twist is that here, you install by enabling the developer mode option provided in Google Chrome. This mode is commonly used for testing extensions or running unpublished tools.
Step 1: Download the mercat extension file
Select and download the mercat extension by clicking the 'Download CRX' button on the website.
Step 2: Extract the downloaded contents
Convert the file to a ZIP file if it is in CRX format then extract the mercat extension zip file or folder that you downloaded. Make sure you extract it using the same folder name and keep it safely in another folder, so you don't delete it by mistake. The extracted folder will be needed to keep your mercat extension running.
Step 3: Open Chrome Extension Setting Page
In the address bar of Google Chrome, type chrome://extensions and open the Chrome Extension Page.
Step 4: Enable Developer Mode
After opening the Chrome Extension page, look at the top right side, and you will find the toggle option of "Developer mode."Simply enable that developer mode option.
Step 5: Load the Unpacked Extension
Once you enable the developer mode option, you will see the menu of Load Unpacked, Pack Extensions and Update. From that, select the option "Load unpacked."
Step 6: Select the Extension Folder
Once the pop-up opens upon clicking Load unpacked, select the mercat extension directory and click on the "Select Folder "button.
Step 7: Confirm and Install
After you select an extension folder of a Google Chrome extension you're installing manually, confirm its installation for the final time and let the installation complete.
Conclusion
Here we've made a step-by-step guide on How to manually install mercat extension in 2 ways. We hope this guide proves helpful.
Similar Extensions
Star History 2 15 ★ 785KiB
Markdown Reader 2 40 ★ 2.07MiB
Mermaid Graphical Editor 2 2 ★ 1.16MiB
GitHub Isometric Contributions 2 102 ★ 101KiB
Cloud Document Converter 2 11 ★ 188KiB
Mermaid Previewer 2 5 ★ 7.01MiB
Graphite 2 7 ★ 10.28KiB
Notion Diagram 2 15 ★ 625KiB
Notion x Excalidraw Helper 2 5 ★ 656KiB
Copy as Markdown 2 31 ★ 31.6KiB
draw.io for Notion 2 57 ★ 38.86KiB
Markdown Editor for Chrome™ 2 15 ★ 645KiB
Le Git Graph - Commits Graph for GitHub 2 29 ★ 814KiB
GitHub Hardware Viewer 2 5 ★ 26.82KiB
UMLGenius 2 1 ★ 36.2KiB
Beautify Markdown 2 0 ★ 729KiB
Mermaid to PlantUML Converter 2 0 ★ 55.93KiB
Mergify 2 5 ★ 10.3KiB
ShowMeTheDiagram (PlantUML viewer) 2 2 ★ 227KiB
Webpage to Markdown and PDF 2 4 ★ 273KiB
HTML Table to Markdown 2 11 ★ 30.29KiB
PlantUML to Mermaid Converter 2 1 ★ 53.19KiB
Quick Draw 2 0 ★ 32.97KiB
Markdown Preview Plus 2 234 ★ 2.24MiB