{"id":13852289,"url":"https://github.com/jonschlinkert/sublime-markdown-extended","last_synced_at":"2025-04-12T23:41:53.579Z","repository":{"id":44361867,"uuid":"11064486","full_name":"jonschlinkert/sublime-markdown-extended","owner":"jonschlinkert","description":"Top 100 Sublime Text plugin! Markdown syntax highlighter for Sublime Text, with extended support for GFM fenced code blocks, with language-specific syntax highlighting. YAML Front Matter. Works with ST2/ST3. Goes great with Assemble.","archived":false,"fork":false,"pushed_at":"2020-06-10T20:12:30.000Z","size":161,"stargazers_count":662,"open_issues_count":76,"forks_count":96,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-04-12T23:41:49.861Z","etag":null,"topics":["gfm","language","markdown","package","st3","sublime","sublime-text","syntax","syntax-highlighting"],"latest_commit_sha":null,"homepage":"https://github.com/jonschlinkert","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonschlinkert.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}},"created_at":"2013-06-30T04:18:47.000Z","updated_at":"2025-03-01T06:16:00.000Z","dependencies_parsed_at":"2022-09-17T16:00:57.794Z","dependency_job_id":null,"html_url":"https://github.com/jonschlinkert/sublime-markdown-extended","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonschlinkert%2Fsublime-markdown-extended","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonschlinkert%2Fsublime-markdown-extended/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonschlinkert%2Fsublime-markdown-extended/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonschlinkert%2Fsublime-markdown-extended/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonschlinkert","download_url":"https://codeload.github.com/jonschlinkert/sublime-markdown-extended/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248647257,"owners_count":21139081,"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":["gfm","language","markdown","package","st3","sublime","sublime-text","syntax","syntax-highlighting"],"created_at":"2024-08-04T22:01:13.465Z","updated_at":"2025-04-12T23:41:53.550Z","avatar_url":"https://github.com/jonschlinkert.png","language":null,"funding_links":[],"categories":["Others"],"sub_categories":[],"readme":"# [sublime-markdown-extended](https://github.com/jonschlinkert/sublime-markdown-extended) [![package control total downloads](https://img.shields.io/packagecontrol/dt/Markdown%20Extended.svg?style=flat-square)](https://packagecontrol.io/packages/Markdown%20Extended/)\n\n\u003e Extends Soda's Monokai and the default markdown styles with additional syntax highlighting for\n\u003e [YAML Front Matter](http://assemble.io/docs/YAML-front-matter.html), GitHub Flavored Markdown\n\u003e (GFM) and language-specific syntax highlighting inside [GFM \"fenced\" code blocks](https://help.github.com/articles/github-flavored-markdown#syntax-highlighting)\n\nAlthough substantial changes have been made, thank you [@aziz](https://github.com/aziz) and other contributors to [Knockdown](https://github.com/aziz/knockdown), for the code for the fenced code blocks.\n\nGet [Monokai Extended](https://github.com/jonschlinkert/sublime-monokai-extended) for better highlighting.\n\n#### [Jump to Examples ↓](#markdown-enhancements)\n\n\n## Getting Started\n\n### 1. Installation\n\n#### Package Control\nIf you already have [Package Control](http://wbond.net/sublime_packages/package_control/) installed in Sublime Text:\n\n* Select \"Install Package\" from the Command Palette: \u003ckbd\u003eCtrl+Shift+P\u003c/kbd\u003e on Windows and Linux or \u003ckbd\u003e⇧⌘P\u003c/kbd\u003e on OS X)\n* Search for \"**Markdown Extended**\" and click \u003ckbd\u003eenter\u003c/kbd\u003e.\n\n\n#### Manual Installation\nGo to `Preferences -\u003e Browse Packages`, and then either download and unzip this plugin into that directory, or:\n\n``` bash\ngit clone https://github.com/jonschlinkert/sublime-markdown-extended.git \"sublime-markdown-extended\"\n```\n\n### 2. Activate this Language\n**After installing this package**, open a markdown file and switch the language to `Markdown Extended`, using one\nof the following methods:\n\n* Select from the list of supported languages in your status bar at the bottom right corner of your editor\n* `ctrl + shift + p` and search for \"Markdown Extended\"\n\n### 3. Make \"Markdown Extended\" the default\nTo make `Markdown Extended` the default highlighting for the current extension:\n\n1. Open a file with the extension you want to set a default for (i.e. `.md`)\n2. Navigate through the following menus in Sublime Text: `View -\u003e Syntax -\u003e Open all with current extension as... -\u003e Markdown Extended`\n\n\n\u003c!-- **Handlebars version**\n\nIncluded in this package is a file named `Markdown Extended.tmLanguage-handlebars`, which provides additional syntax highlighting for Handlebars syntax inside markdown files.\n\nIf you use [assemble](http://assemble.io) for generating documentation, sites or components, then activate the Handlebars version instead. To do so, first delete `Markdown Extended.tmLanguage`, then renamed the extension of `Markdown Extended.tmLanguage-handlebars` to just `.tmLanguage`. --\u003e\n\n\n## Features:\n* Support for [YAML Front Matter](http://assemble.io/docs/YAML-front-matter.html)\n* Support for [GFM \"fenced\" code blocks](https://help.github.com/articles/github-flavored-markdown#syntax-highlighting)\n* Language-specific syntax highlighting support inside [GFM \"fenced\" code blocks](https://help.github.com/articles/github-flavored-markdown#syntax-highlighting) for most popular languages (see below for the list of supported languages)\n* Syntax highlighting for URLs in text which is auto-linked by GFM\n* Proper syntax highlighting for bullets and numbers in ordered/unordered lists\n* Proper syntax highlighting for bold and italics by ignoring multiple underscores in words\n\n\n## Markdown Enhancements\nThe following examples use the [Monokai Extended](https://github.com/jonschlinkert/sublime-monokai-extended) theme.\n\n\n## Whitespace\n\n### Significant whitespace\n\n**Whitespace is significant** _only directly before and directly after fenced code blocks_! Following these instructions will ensure that highlighting works properly and consistently._\n\nThis is very simple:\n\n* **Add a newline** before and after clode blocks\n* **No trailing spaces** after the last code block\n\nIf you don't, it won't break your code but it won't always look awesome.\n\n### Comparisons with and without proper whitespace\n\n#### Whitespace before the block\nYou will need to keep a space above and below fenced code blocks for predictable results with syntax highlighting. For example, this is what it looks like when there is no space before a fenced code block:\n\n![image](https://f.cloud.github.com/assets/383994/782115/470ca012-ea35-11e2-940c-5919386f26bf.png)\n\nThis is what it looks like with proper spacing:\n\n![image](https://f.cloud.github.com/assets/383994/782119/5b27105a-ea35-11e2-9ea8-7a195f381d7c.png)\n\n#### Whitespace after the block\n\nAlso add a new line after code blocks, but make sure that there is no trailing whitespace next to the bottom fence.\n\n**With a trailing whitespace**\n\n![image](https://f.cloud.github.com/assets/383994/782152/0217cb20-ea36-11e2-8cfd-2ea47136fb0c.png)\n\n**Without a trailing whitespace**\n\n![image](https://f.cloud.github.com/assets/383994/782145/f534f1da-ea35-11e2-8689-d606494f7830.png)\n\n### Supported languages\n\nThe following languages are highlighted inside fenced code blocks:\n\nNote that in order for a language to be highlighted properly, you must have the language installed in Sublime Text.\n\n* `coffee|coffeescript`\n* `coffee front matter`\n* `cpp`\n* `csharp`\n* `css`\n* `c`\n* `c++`\n* `diff`\n* `ejs`\n* `erlang`\n* `underscore`\n* `go`\n* `graphql`\n* `lodash`\n* `handlebars|hbs`: requires the Sublime Text [Handlebars](https://github.com/daaain/Handlebars) package\n* `html|html5`\n* `ini`\n* `jade`\n* `java`\n* `javascript|js`\n* `json`\n* `json front matter`\n* `julia`\n* `less`\n* `ls|livescript|LiveScript`\n* `lua`\n* `md|markdown`\n* `nginx`\n* `objective-c`\n* `objective-c++`\n* `perl`\n* `r`\n* `ruby`\n* `sass`\n* `scala`\n* `scss`\n* `shell`\n* `bash`\n* `sql|ddl|dml`\n* `postgresql|postgres|pgsql`\n* `styl`\n* `swift`\n* `swig`\n* `liquid`\n* `xml`\n* `yaml`\n* `yaml front matter`\n\n\n### CSS\n#### Before\n![image](https://f.cloud.github.com/assets/383994/1525715/7ece6886-4bd9-11e3-831b-e956c5feddba.png)\n\n#### After\n![image](https://f.cloud.github.com/assets/383994/1525717/872193d2-4bd9-11e3-8b44-7dfb08b3aac2.png)\n\n\n### LESS\n#### Before\n![image](https://f.cloud.github.com/assets/383994/1525757/0e74a69e-4bda-11e3-8218-e7adc619b5ae.png)\n\n#### After\n![image](https://f.cloud.github.com/assets/383994/1525760/16ba0376-4bda-11e3-9f54-8cf039c8a6f9.png)\n\n\n### HTML\n#### Before\n![image](https://f.cloud.github.com/assets/383994/1525726/b049629e-4bd9-11e3-853f-04e2e704bbea.png)\n\n#### After\n![image](https://f.cloud.github.com/assets/383994/1525730/b6b4f652-4bd9-11e3-9bab-ab26bf8fc761.png)\n\n\n### JavaScript\n#### Before\n![image](https://f.cloud.github.com/assets/383994/1525736/d94cf5f2-4bd9-11e3-98ff-578062c33853.png)\n\n#### After\n![image](https://f.cloud.github.com/assets/383994/1525739/e09b5006-4bd9-11e3-81a3-17d18527dafa.png)\n\n\n### Coffee\n#### Before\n![image](https://f.cloud.github.com/assets/383994/1525694/1d80acb0-4bd9-11e3-9527-b20bde8ceb0f.png)\n\n#### After\n![image](https://f.cloud.github.com/assets/383994/1525696/2c83774c-4bd9-11e3-83ac-fe70d00e8088.png)\n\n\n### LiveScript\n#### Before\n![image](https://f.cloud.github.com/assets/922234/2147750/62c04f60-93d7-11e3-95bd-bdf287e09751.png)\n#### After\n![image](https://f.cloud.github.com/assets/922234/2147749/62c01cd4-93d7-11e3-956b-058cafade685.png)\n\n\n### Shell\n#### Before\n![image](https://f.cloud.github.com/assets/383994/851162/38fc84ae-f496-11e2-9014-81b91da16232.png)\n\n#### After\n![image](https://f.cloud.github.com/assets/383994/851165/468b3282-f496-11e2-8a2d-ebf6f9c925f6.png)\n\n### YAML Front Matter\nSee [gray-matter](https://github.com/assemble/gray-matter)\n\n#### Before\n![image](https://f.cloud.github.com/assets/383994/726861/2f03fb2a-e13c-11e2-9df0-cb9514b301fe.png)\n\n#### After\n![image](https://f.cloud.github.com/assets/383994/726865/aa2cdb6e-e13c-11e2-89b0-c06923447ec9.png)\n\n### Coffee Front Matter\nSee [gray-matter](https://github.com/assemble/gray-matter)\n\n#### Before\n![image](https://f.cloud.github.com/assets/383994/2179180/fe679602-9694-11e3-938b-1e74196d4341.png)\n\n#### After\n![image](https://f.cloud.github.com/assets/383994/2179172/82a6dc1c-9694-11e3-89f1-772bedf02384.png)\n\n\n## Authors\n\n**Jon Schlinkert**\n\n+ [http://twitter.com/jonschlinkert](http://twitter.com/jonschlinkert)\n+ [http://github.com/jonschlinkert](http://github.com/jonschlinkert)\n\n**Alexander Krivoshhekov**\n\n+ [http://twitter.com/FlatDev](http://twitter.com/FlatDev)\n+ [http://github.com/SuperPaintman](http://github.com/SuperPaintman)\n\n## Copyright and license\nCopyright 2013-2015 Jon Schlinkert\n\n[MIT License](LICENSE-MIT)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonschlinkert%2Fsublime-markdown-extended","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonschlinkert%2Fsublime-markdown-extended","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonschlinkert%2Fsublime-markdown-extended/lists"}