{"id":13428661,"url":"https://github.com/vsch/idea-multimarkdown","last_synced_at":"2025-04-12T21:23:49.857Z","repository":{"id":28577469,"uuid":"32095357","full_name":"vsch/idea-multimarkdown","owner":"vsch","description":"Markdown language support for IntelliJ IDEA.","archived":false,"fork":false,"pushed_at":"2023-05-10T21:26:01.000Z","size":5202866,"stargazers_count":819,"open_issues_count":134,"forks_count":127,"subscribers_count":33,"default_branch":"master","last_synced_at":"2025-04-04T00:33:41.780Z","etag":null,"topics":["intellij-plugin","markdown-editor","markdown-to-html","markdown-toc","markdown-viewer"],"latest_commit_sha":null,"homepage":"https://plugins.jetbrains.com/plugin/7896-markdown-navigator","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vsch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2015-03-12T18:46:23.000Z","updated_at":"2025-03-23T06:46:06.000Z","dependencies_parsed_at":"2024-01-07T04:49:33.166Z","dependency_job_id":null,"html_url":"https://github.com/vsch/idea-multimarkdown","commit_stats":null,"previous_names":[],"tags_count":88,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsch%2Fidea-multimarkdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsch%2Fidea-multimarkdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsch%2Fidea-multimarkdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsch%2Fidea-multimarkdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vsch","download_url":"https://codeload.github.com/vsch/idea-multimarkdown/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248632754,"owners_count":21136750,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["intellij-plugin","markdown-editor","markdown-to-html","markdown-toc","markdown-viewer"],"created_at":"2024-07-31T01:01:02.385Z","updated_at":"2025-04-12T21:23:49.825Z","avatar_url":"https://github.com/vsch.png","language":"Kotlin","readme":"\u003cimg src=\"https://github.com/vsch/idea-multimarkdown/raw/master/assets/images/MNLogo.png\" height=\"64\" width=\"64\" align=\"absmiddle\"\u003e Markdown Navigator 3.0\n==========================================================================================================================================================\n\n[TOC]: #\n\n### Table of Contents\n- [Overview](#overview)\n  - [Document with pleasure!](#document-with-pleasure)\n  - [Two tier model](#two-tier-model)\n  - [Source](#source)\n- [Background](#background)\n\n## Overview\n\n![Screenshot](/assets/images/capabilities2.png)\n\n**[\u003cspan style=\"color:#30A0D8;\"\u003eMarkdown\u003c/span\u003e][Markdown] language support for IntelliJ\nplatform**\n\n**You can download it on the [JetBrains plugin page].**\n\n### Document with pleasure!\n\nWork with [Markdown] files like you do with other languages in the IDE, by getting full support\nfor:\n\n* **Paste images** into documents for fast screen capture links\n* **Drag \u0026 Drop files and images** for fast link insertion\n* **Drag and Drop** text, HTML or links from other applications\n* **Formatting** to clean up documents with a keystroke\n* **Navigation and Find Usages** to find references without effort\n* **Copy Markdown** as **JIRA**, **YouTrack** or **HTML** formatted text\n* Convert **HTML to Markdown by pasting** it into a Markdown document.\n* **Export** to **HTML** or **PDF** to share with others\n* **Refactoring** of all referencing elements:\n  * files ⟺ links\n  * headings ⟺ ref anchors\n  * footnotes ⟺ footnote refs\n  * references ⟺ ref links/ref images\n* **Completions** to reduce typing:\n  * link address ⇐ files\n  * ref anchors ⇐ headings\n  * footnote refs ⇐ footnotes\n  * ref links/ref images ⇐ references\n  * link text ⇐ ref anchor/link address\n* **Error and Warning** annotations to help catch mistakes early\n* **Intention actions** for fast results with less effort\n* **Wrap on Typing** to keep it nicely formatted as you edit\n* **GitHub style rendering** that you are used to, out of the box\n* **GitLab parsing and rendering** extensions\n  * **Math** extension using [Katex](https://github.com/Khan/KaTeX)\n  * **Charts** extension using [Mermaid](https://github.com/knsv/mermaid)\n* **Math block and inline** rendering by [Katex] or [codecogs.com]\n* **PlantUML fenced code** rendering by [PlantUML] or [gravizo.com]\n* **Fast typing response** for distraction free editing\n* **Fully customizable** to adjust to your preferences and project needs\n\n### Two tier model\n\n1. Previewing, syntax highlighting, basic editing functionality with link completions with split\n   editor preview is available in the basic open source edition. Intended for mostly previewing\n   and editing of Markdown documents without full document format.\n\n2. Advanced features used for creating and maintaining Markdown documents: refactoring, find\n   usages, validation and auto formatting were available with the Enhanced version, from the\n   [JetBrains Marketplace].\n\n   :information_source: The latest release is only to address compatibility issues for newer\n   IDEs from 2021.3 to 2023.1.1.\n\n   **It is a full-featured Enhanced version, released without needing a license.**\n\n   It is only intended as a measure to allow users, who depended on this plugin for their\n   workflow, to have a working solution until I can figure out if it is possible to continue\n   maintaining this plugin in an economically sustainable manner and return Markdown Navigator\n   Enhanced to the [JetBrains Marketplace] as a paid plugin, or let it go for good.\n\n### Source\n\nThe source in this repository is for the unlicensed version of the plugin. As such, it does not\nhave all the features of the enhanced version.\n\n#### Working with the source\n\nIntelliJ Gradle Plugin development environment. See [Building from sources](BUILD.md)\n\n#### Some internal details, should you care to know\n\nThe [pegdown][] [Markdown] parser used by the plugin in its original incarnation was changed to\n[flexmark-java] and [pegdown] dependencies have been removed as of version 2.2.0.\n\n[flexmark-java] is a fork of [commonmark-java], with changes:\n\n* source element based AST with detailed break down of each element for syntax highlighting\n* complete source position tracking for all elements and their lexical parts\n* optimized for efficient parsing with many parser extensions installed\n* unified core and extension options API to simplify parser/renderer configuration\n* options to tweak core parser rules\n\nOn the coding end, the new parser is a joy to maintain and enhance. The parser architecture,\ninherited from [commonmark-java], is easy to debug and test. Markdown element parsers have\nlittle or no interdependencies with other element parsers making it easy to fine tune parser\nbehaviour on a per-element basis and add parser configuration options to emulate other Markdown\nprocessors. All this is in contrast to pegdown's one big PEG grammar implementation with\neverything potentially inter-dependent.\n\n## Background\n\nIt all started with a desire to see Markdown files in PhpStorm IDE as they would look on GitHub.\nI was already using [nicoulaj/idea-markdown plugin] but found its preview was more like\n[Craig's List] than [GitHub]. It did not appear to have been recently updated, so I decided to\nfork it and modify its style sheet. How hard could that be?\n\nI found out quickly that there was more to it than meets the eye. Rendering is done by Swing not\na browser, the parser is HTML 3.1, with many features not implemented. Additionally, the Table\nextension did not work in `pegdown` version used by the plugin.\n\nI upgraded the plugin to use the latest `pegdown`, `parboiled`. Fixed a few bugs. I was already\nin the code, so I might as well add a few more features like user editable style sheet, fix a\nfew more bugs, add updates to preview so that I could split the editor pane and edit in one\nwhile seeing the preview in the other.\n\nNow, years later, the plugin is brimming with features to make Markdown editing and creation a\nbreeze. It was a lot more work, and code, than I imagined but more satisfying that I had hoped.\n\nIt has been a fun trip down the rabbit hole of IntelliJ IDEA plugin development which started\nwith a simple desire for a Markdown preview that looked like GitHub's.\n\n---\n\n\\* This plugin was originally based on the [nicoulaj/idea-markdown plugin] by [nicoulaj], which\nwas based on [pegdown] library by [sirthias].\n\nMarkdown Navigator, Copyright (c) 2015-2023, Vladimir Schneider, All Rights Reserved.\n\n[JetBrains Marketplace]: https://plugins.jetbrains.com/idea/plugin/7896-markdown-navigator-enhanced\n[codecogs.com]: https://codecogs.com\n[commonmark-java]: https://github.com/atlassian/commonmark-java\n[Craig's List]: https://montreal.craigslist.ca/?lang=en\u0026cc=us\n[GitHub]: https://github.com/vsch/laravel-translation-manager\n[JetBrains plugin page]: https://plugins.jetbrains.com/plugin/7896-markdown-navigator-enhanced\n[Katex]: https://github.com/Khan/KaTeX\n[Markdown]: https://daringfireball.net/projects/markdown\n[PlantUML]: https://plantuml.com\n[flexmark-java]: https://github.com/vsch/flexmark-java\n[gravizo.com]: https://gravizo.com\n[nicoulaj]: https://github.com/nicoulaj\n[nicoulaj/idea-markdown plugin]: https://github.com/nicoulaj/idea-markdown\n[pegdown]: http://pegdown.org\n[sirthias]: https://github.com/sirthias\n\n","funding_links":[],"categories":["Libraries","others","Kotlin","Android Studio"],"sub_categories":["Plugins"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvsch%2Fidea-multimarkdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvsch%2Fidea-multimarkdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvsch%2Fidea-multimarkdown/lists"}