- \n
- two\n
- three
- \n
- \n ```\n \n After (output):\n ```html\n
- one \n
- two\n
- three
\n - a
- \n
hello world!\n\n**Actual Output:**\n\n
hello **world**!
\n\n\n\n# Want a Feature?\nYou can request a new feature by submitting an issue. If you would like to implement a new feature feel free to issue a\nPull Request.\n\n\n# Pull requests (PRs)\nPRs are awesome. However, before you submit your pull request consider the following guidelines:\n\n - Search GitHub for an open or closed Pull Request that relates to your submission. You don't want to duplicate effort.\n - When issuing PRs that change code, make your changes in a new git branch based on develop:\n\n ```bash\n git checkout -b my-fix-branch develop\n ```\n\n - Run the full test suite before submitting and make sure all tests pass (obviously =P).\n - Try to follow our [**coding style rules**](https://github.com/showdownjs/code-style/blob/master/README.md).\n Breaking them prevents the PR to pass the tests.\n - Refrain from fixing multiple issues in the same pull request. It's preferable to open multiple small PRs instead of one\n hard to review big one. Also, don't reuse old forks (or PRs) to fix new issues.\n - If the PR introduces a new feature or fixes an issue, please add the appropriate test case.\n - We use commit notes to generate the changelog. It's extremely helpful if your commit messages adhere to the\n [**AngularJS Git Commit Guidelines**](https://github.com/showdownjs/code-style/blob/master/README.md#commit-message-convention).\n - If we suggest changes then:\n - Make the required updates.\n - Re-run the Angular test suite to ensure tests are still passing.\n - Rebase your branch and force push to your GitHub repository (this will update your Pull Request):\n\n ```bash\n git rebase develop -i\n git push origin my-fix-branch -f\n ```\n - After your pull request is merged, you can safely delete your branch.\n\nIf you have time to contribute to this project, we feel obliged that you get credit for it.\nThese rules enable us to review your PR faster and will give you appropriate credit in your GitHub profile.\nWe thank you in advance for your contribution!\n\n\n# Joining the team\nWe're looking for members to help maintaining Showdown.\nPlease see [this issue](https://github.com/showdownjs/showdown/issues/114) to express interest or comment on this note.\n" }, { "path": "CREDITS.md", "content": "Credits\n=======\n \n - Showdown v2\n * [Estevão Santos](https://github.com/tivie)\n * [SyntaxRules](https://github.com/SyntaxRules)\n\n - Showdown v1\n * [Estevão Santos](https://github.com/tivie)\n * [Pascal Deschênes](https://github.com/pdeschen)\n\n - Showdown v0\n * [Corey Innis](http://github.com/coreyti):\n Original GitHub project maintainer\n * [Remy Sharp](https://github.com/remy/):
\n CommonJS-compatibility and more\n * [Konstantin Käfer](https://github.com/kkaefer/):
\n CommonJS packaging\n * [Roger Braun](https://github.com/rogerbraun):
\n Github-style code blocks\n * [Dominic Tarr](https://github.com/dominictarr):
\n Documentation\n * [Cat Chen](https://github.com/CatChen):
\n Export fix\n * [Titus Stone](https://github.com/tstone):
\n Mocha tests, extension mechanism, and bug fixes\n * [Rob Sutherland](https://github.com/roberocity):
\n The idea that lead to extensions\n * [Pavel Lang](https://github.com/langpavel):
\n Code cleanup\n * [Ben Combee](https://github.com/unwiredben):
\n Regex optimization\n * [Adam Backstrom](https://github.com/abackstrom):
\n WebKit bugfix\n * [Pascal Deschênes](https://github.com/pdeschen):
\n Grunt support, extension fixes + additions, packaging improvements, documentation\n * [Estevão Santos](https://github.com/tivie)
\n Bug fixing and late maintainer\n * [Hannah Wolfe](https://github.com/ErisDS)
\n Bug fixes\n * [Alexandre Courtiol](https://github.com/acourtiol)
\n Bug fixes and build optimization\n * [Karthik Balakrishnan](https://github.com/torcellite)
\n Support for table alignment\n * [rheber](https://github.com/rheber)
\n Cli\n \n\n - Original Project\n * [John Gruber](http://daringfireball.net/projects/markdown/)
\n Author of Markdown\n * [John Fraser](http://attacklab.net/)
\n Author of Showdown\n" }, { "path": "DONATIONS.md", "content": "We would like to thank everyone that contributed to this library. If you find our library useful and wish to donate as well, you can do so [through patreon](https://www.patreon.com/showdownjs) or directly [through paypal](https://www.paypal.me/tiviesantos)!! Your contribution will be greatly appreciated.\n\n# Sponsors\n\n## Platinum Supporters\n\n## Gold Supporters\n\n## Silver Supporters\n\n\n# Patron Supporters\n\n## Awesome Supporter\n\n## Cool Supporter\n\n## Supporter\n\n - Ricardo Jordão\n \n - Tiago Silva\n\n\n---\n\n# One Time Donors\n\n- [**Learn on demand Systems**](http://www.learnondemandsystems.com/) (1000$)\n\n- **Nothing AG** (25€)\n\n > Thank you for developing Showdown :)\n\n- **Sam Huffman** (15$)\n\n > Thanks for the great work on showdown.js! I've been looking for a good solution to serve wiki-like text to a browser and render as\n HTML but nearly gave up after mixed success with wikitext. Your library gets me very close to where I want to be.\n\n- **Maya Lekova** (10$)\n\n > Great work with the showdown library! I just used it and it worked exactly the way I expected \n (given a complex inline HTML inside the Markdown, which renders fine with other viewers). \n The other libraries I've tried (markdown-it and marked) produced a lot of bogus output. Y\n our library saved me at least half a day, thanks! Good luck :)\n\n- **Lin Wang** (10$)\n\n- **Walter Schnell** (10$)\n\n- **ivanhjc** (5$)\n\n- **Asbjørn Ulsberg** (5$)\n\n > Thanks for the ShowdownJS support!\n\n- **Juan Marcelo Russo** (1$)\n" }, { "path": "Gruntfile.js", "content": "/**\n * Created by Tivie on 12-11-2014.\n */\n\nmodule.exports = function (grunt) {\n\n if (grunt.option('q') || grunt.option('quiet')) {\n require('quiet-grunt');\n }\n\n /**\n * Load common tasks for legacy and normal tests\n */\n grunt.loadNpmTasks('grunt-contrib-clean');\n grunt.loadNpmTasks('grunt-contrib-concat');\n grunt.loadNpmTasks('grunt-contrib-uglify');\n grunt.loadNpmTasks('grunt-mocha-test');\n grunt.loadNpmTasks('grunt-endline');\n grunt.loadNpmTasks('grunt-contrib-jshint');\n\n // Project configuration.\n var config = {\n pkg: grunt.file.readJSON('package.json'),\n\n concat: {\n dist: {\n options: {\n sourceMap: true,\n banner: ';/*! <%= pkg.name %> v <%= pkg.version %> - <%= grunt.template.today(\"dd-mm-yyyy\") %> */\\n(function(){\\n',\n footer: '}).call(this);\\n'\n },\n src: [\n 'src/options.js',\n 'src/showdown.js',\n 'src/helpers.js',\n 'src/subParsers/makehtml/*.js',\n 'src/subParsers/makemarkdown/*.js',\n 'src/converter.js',\n 'src/loader.js'\n ],\n dest: 'dist/<%= pkg.name %>.js'\n },\n cli: {\n src: [\n 'src/cli/cli.js'\n ],\n dest: 'bin/showdown.js'\n },\n test: {\n src: '<%= concat.dist.src %>',\n dest: '.build/<%= pkg.name %>.js',\n options: {\n sourceMap: false\n }\n }\n },\n\n clean: ['.build/'],\n\n uglify: {\n dist: {\n options: {\n sourceMap: true,\n banner: '/*! <%= pkg.name %> v <%= pkg.version %> - <%= grunt.template.today(\"dd-mm-yyyy\") %> */'\n },\n files: {\n 'dist/<%= pkg.name %>.min.js': ['<%= concat.dist.dest %>']\n }\n },\n cli: {\n options: {\n sourceMap: false,\n banner: '#!/usr/bin/env node'\n },\n files: {\n 'bin/showdown.js': ['<%= concat.cli.dest %>']\n }\n }\n },\n\n endline: {\n dist: {\n files: {\n 'dist/<%= pkg.name %>.js': 'dist/<%= pkg.name %>.js',\n 'dist/<%= pkg.name %>.min.js': 'dist/<%= pkg.name %>.min.js'\n }\n }\n },\n\n jshint: {\n options: {\n jshintrc: '.jshintrc'\n },\n files: [\n 'Gruntfile.js',\n 'src/**/*.js',\n 'test/**/*.js'\n ]\n },\n\n eslint: {\n options: {\n overrideConfigFile: '.eslintrc.json'\n },\n target: [\n 'Gruntfile.js',\n 'src/**/*.js',\n 'test/**/*.js'\n ]\n },\n\n conventionalChangelog: {\n options: {\n changelogOpts: {\n preset: 'angular'\n }\n },\n release: {\n src: 'CHANGELOG.md'\n }\n },\n\n conventionalGithubReleaser: {\n release: {\n options: {\n auth: {\n type: 'oauth',\n token: process.env.GH_TOEKN\n },\n changelogOpts: {\n preset: 'angular'\n }\n }\n }\n },\n\n mochaTest: {\n functional: {\n src: 'test/functional/**/*.js',\n options: {\n timeout: 3000,\n ignoreLeaks: true,\n reporter: 'spec',\n require: ['test/bootstrap.js']\n }\n },\n unit: {\n src: 'test/unit/**/*.js',\n options: {\n timeout: 3000,\n ignoreLeaks: true,\n reporter: 'spec',\n require: ['test/bootstrap.js']\n }\n },\n single: {\n options: {\n timeout: 3000,\n ignoreLeaks: false,\n reporter: 'spec',\n require: ['test/bootstrap.js']\n }\n },\n cli: {\n src: 'test/unit/cli.js',\n options: {\n timeout: 3000,\n ignoreLeaks: false,\n reporter: 'spec',\n require: ['test/bootstrap.js']\n }\n }\n }\n };\n\n grunt.initConfig(config);\n\n /**\n * Generate Changelog\n */\n grunt.registerTask('generate-changelog', function () {\n 'use strict';\n grunt.loadNpmTasks('grunt-conventional-changelog');\n grunt.loadNpmTasks('grunt-conventional-github-releaser');\n grunt.task.run('conventionalChangelog');\n });\n\n /**\n * Lint tasks\n */\n grunt.registerTask('lint', function () {\n 'use strict';\n grunt.loadNpmTasks('grunt-eslint');\n grunt.task.run('jshint', 'eslint');\n });\n\n /**\n * Performance task\n */\n grunt.registerTask('performancejs', function () {\n 'use strict';\n var perf = require('./test/performance/performance.js');\n perf.runTests();\n perf.generateLogs();\n });\n\n /**\n * Run a single test\n */\n grunt.registerTask('single-test', function (file) {\n 'use strict';\n grunt.config.merge({\n mochaTest: {\n single: {\n src: file\n }\n }\n });\n\n grunt.task.run(['lint', 'concat:test', 'mochaTest:single', 'clean']);\n });\n\n /**\n * Tasks\n */\n grunt.registerTask('test', ['clean', 'lint', 'concat:test', 'mochaTest:unit', 'mochaTest:functional', 'clean']);\n grunt.registerTask('test-functional', ['concat:test', 'mochaTest:functional', 'clean']);\n grunt.registerTask('test-unit', ['concat:test', 'mochaTest:unit', 'clean']);\n grunt.registerTask('test-cli', ['clean', 'lint', 'concat:test', 'mochaTest:cli', 'clean']);\n\n grunt.registerTask('performance', ['concat:test', 'performancejs', 'clean']);\n grunt.registerTask('build', ['test', 'concat:dist', 'concat:cli', 'uglify:dist', 'uglify:cli', 'endline']);\n grunt.registerTask('build-without-test', ['concat:dist', 'uglify', 'endline']);\n grunt.registerTask('prep-release', ['build', 'performance', 'generate-changelog']);\n\n // Default task(s).\n grunt.registerTask('default', ['test']);\n};\n" }, { "path": "LICENSE", "content": "MIT License\n\nCopyright (c) 2018,2021 ShowdownJS\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n" }, { "path": "README.md", "content": "![Showdown][sd-logo]\n\n\n\n[](https://automate.browserstack.com/public-build/VTIvTDNqWVdaTHljbS9RNmYrcTBiL0Uxc3dkRDhaN1dPaXpPb2VOc1B2VT0tLU1Ib09kVjVzMjhFcHExbWFSWlJEV3c9PQ==--1fb92e1730e4a00630d17d533822de6403ca65ec)\n[](http://badge.fury.io/js/showdown)\n[](http://badge.fury.io/bo/showdown)\n[](https://www.paypal.me/tiviesantos)\n\n------\n\nShowdown is a JavaScript Markdown to HTML converter, based on the original works by John Gruber.\nShowdown can be used client side (in the browser) or server side (with Node.js).\n\n## Live DEMO\n\n\n\nAs you know, ShowdownJS is a free library and it will remain free forever. However, maintaining and improving the library costs time and money.\n\nIf you like our work and find our library useful, please donate through [PayPal](https://www.paypal.me/tiviesantos)! Your contribution will be greatly appreciated and help me continue to develop this awesome library.\n\n## License\n\nShowdownJS v 2.0 is released under the MIT license.\nPrevious versions are released under BSD.\n\n## Who uses Showdown (or a fork)\n\n - [GoogleCloudPlatform](https://github.com/GoogleCloudPlatform)\n - [Meteor](https://www.meteor.com/)\n - [Stackexchange](http://stackexchange.com/) - forked as [PageDown](https://code.google.com/p/pagedown/)\n - [docular](https://github.com/Vertafore/docular)\n - [md-page](https://github.com/oscarmorrison/md-page)\n - [QCObjects](https://qcobjects.dev)\n - [and some others...](https://www.npmjs.com/browse/depended/showdown)\n\n## Installation\n\n### Download tarball\n\nYou can download the latest release tarball directly from [releases][releases].\n\n### Bower\n\n bower install showdown\n\n### npm (server-side)\n\n npm install showdown\n\n### NuGet package\n\n PM> Install-Package showdownjs\n\nThe NuGet Packages can be found [here](https://www.nuget.org/packages/showdownjs/).\n\n### CDN\n\nYou can also use one of several CDNs available: \n\n* jsDelivr\n\n https://cdn.jsdelivr.net/npm/showdown@
hello, markdown!
\n```\n\n## Options\n\nYou can change some of showdown's default behavior through options. \n\n### Setting options\n\nOptions can be set:\n\n#### Globally\n\nSetting a \"global\" option affects all instances of showdown\n\n```js\nshowdown.setOption('optionKey', 'value');\n```\n\n#### Locally\nSetting a \"local\" option only affects the specified Converter object. \nLocal options can be set:\n\n * **through the constructor**\n ```js\n var converter = new showdown.Converter({optionKey: 'value'});\n ```\n\n * **through the setOption() method**\n ```js\n var converter = new showdown.Converter();\n converter.setOption('optionKey', 'value');\n ```\n\n### Getting an option\n\nShowdown provides 2 methods (both local and global) to retrieve previous set options.\n\n#### getOption()\n\n```js\n// Global\nvar myOption = showdown.getOption('optionKey');\n\n//Local\nvar myOption = converter.getOption('optionKey');\n```\n\n#### getOptions()\n\n```js\n// Global\nvar showdownGlobalOptions = showdown.getOptions();\n\n//Local\nvar thisConverterSpecificOptions = converter.getOptions();\n```\n\n### Retrieve the default options\n\nYou can get showdown's default options with:\n```js\nvar defaultOptions = showdown.getDefaultOptions();\n```\n\n### Valid Options\n\n * **omitExtraWLInCodeBlocks**: (boolean) [default false] Omit the trailing newline in a code block. Ex:\n \n This:\n ```html\nvar foo = 'bar';\n
var foo = 'bar';
foo
\n ```\n\n * **parseImgDimensions**: (boolean) [default false] Enable support for setting image dimensions from within markdown syntax.\n Examples:\n ```\n  simple, assumes units are in px\n  sets the height to \"auto\"\n  Image with width of 80% and height of 5em\n ```\n\n * **simplifiedAutoLink**: (boolean) [default false] Turning this option on will enable automatic linking to urls.\n This means that:\n\n ```md\n some text www.google.com\n ```\n will be parsed as \n ```html\nsome text www.google.com\n ```\n \n * ~~**excludeTrailingPunctuationFromURLs**: (boolean) [default false] This option excludes trailing punctuation from autolinking urls.\n Punctuation excluded: `. ! ? ( )`. Only applies if **simplifiedAutoLink** option is set to `true`.~~\n \n * **literalMidWordUnderscores**: (boolean) [default false] Turning this on will stop showdown from interpreting\n underscores in the middle of words as `` and `` and instead treat them as literal underscores.\n\n Example:\n \n ```md\n some text with__underscores__in middle\n ```\n will be parsed as\n ```html\n some text with__underscores__in middle a line tags around block-level tags.\n text = showdown.subParser('makehtml.hashHTMLBlocks')(text, options, globals);\n text = showdown.subParser('makehtml.paragraphs')(text, options, globals);\n\n text = globals.converter._dispatch('makehtml.blockGamut.after', text, options, globals).getText();\n\n return text;\n});\n\nshowdown.subParser('makehtml.blockQuotes', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.blockQuotes.before', text, options, globals).getText();\n\n // add a couple extra lines after the text and endtext mark\n text = text + '\\n\\n';\n\n var rgx = /(^ {0,3}>[ \\t]?.+\\n(.+\\n)*\\n*)+/gm;\n\n if (options.splitAdjacentBlockquotes) {\n rgx = /^ {0,3}>[\\s\\S]*?(?:\\n\\n)/gm;\n }\n\n text = text.replace(rgx, function (bq) {\n // attacklab: hack around Konqueror 3.5.4 bug:\n // \"----------bug\".replace(/^-/g,\"\") == \"bug\"\n bq = bq.replace(/^[ \\t]*>[ \\t]?/gm, ''); // trim one level of quoting\n\n // attacklab: clean up hack\n bq = bq.replace(/¨0/g, '');\n\n bq = bq.replace(/^[ \\t]+$/gm, ''); // trim whitespace-only lines\n bq = showdown.subParser('makehtml.githubCodeBlocks')(bq, options, globals);\n bq = showdown.subParser('makehtml.blockGamut')(bq, options, globals); // recurse\n\n bq = bq.replace(/(^|\\n)/g, '$1 ');\n // These leading spaces screw with Just type strikethrough`\n \n * **tables**: (boolean) [default false] Enable support for tables syntax. Example:\n \n ```md\n | h1 | h2 | h3 |\n |:------|:-------:|--------:|\n | 100 | [a][1] | ![b][2] |\n | *foo* | **bar** | ~~baz~~ |\n ```\n \n See the wiki for more info\n\n * **tablesHeaderId**: (boolean) [default false] If enabled adds an id property to table headers tags.\n\n * **ghCodeBlocks**: (boolean) [default true] Enable support for GFM code block style.\n\n * **tasklists**: (boolean) [default false] Enable support for GFM tasklists. Example:\n \n ```md\n - [x] This task is done\n - [ ] This is still pending\n ```\n * **smoothLivePreview**: (boolean) [default false] Prevents weird effects in live previews due to incomplete input\n \n * **smartIndentationFix**: (boolean) [default false] Tries to smartly fix indentation problems related to es6 template\n strings in the midst of indented code.\n\n * **disableForced4SpacesIndentedSublists**: (boolean) [default false] Disables the requirement of indenting sublists\n by 4 spaces for them to be nested, effectively reverting to the old behavior where 2 or 3 spaces were enough.\n **(since v1.5.0)**\n \n * **simpleLineBreaks**: (boolean) [default false] Parses line breaks as `
`, without\n needing 2 spaces at the end of the line **(since v1.5.1)**\n \n ```md\n a line \n wrapped in two\n ```\n \n turns into:\n \n ```html\n
\n wrapped in two
\n[](https://www.jetbrains.com/webstorm/)\n\n\n\n[sd-logo]: https://raw.githubusercontent.com/showdownjs/logo/master/dist/logo.readme.png\n[legacy-branch]: https://github.com/showdownjs/showdown/tree/legacy\n[releases]: https://github.com/showdownjs/showdown/releases\n[changelog]: https://github.com/showdownjs/showdown/blob/master/CHANGELOG.md\n[wiki]: https://github.com/showdownjs/showdown/wiki\n[cli-wiki]: https://github.com/showdownjs/showdown/wiki/CLI-tool\n[definitely-typed]: https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/showdown\n[xss-wiki]: https://github.com/showdownjs/showdown/wiki/Markdown's-XSS-Vulnerability-(and-how-to-mitigate-it)\n[ext-wiki]: https://github.com/showdownjs/showdown/wiki/extensions\n[coding-rules]: https://github.com/showdownjs/code-style/blob/master/README.md\n[conventional-commits]: https://www.conventionalcommits.org/\n[boilerplate-repo]: https://github.com/showdownjs/extension-boilerplate\n"
},
{
"path": "SECURITY.md",
"content": "# Security Policy\n\n## Supported Versions\n\nSecurity fixes are addressed for the following versions of Showdown.\n\n| Version | Supported |\n| ------- | ------------------ |\n| 2.0.x | :white_check_mark: |\n| 1.x.x | :x: (Known security issue with yargs dependecy) |\n\nShowdown targets the node.js versions targeted in the [node.js release schedule](https://nodejs.org/en/about/releases/). Our test suite follows this release schedule. Consequently, older versions of node may become unusable.\n\n## Reporting a Vulnerability\n\nTo report a vulnerability, please add an issue to our main github page: https://github.com/showdownjs/showdown/issues\n"
},
{
"path": "TASKS.TODO.md",
"content": "# ROADMAP TO VERSION 3.0\n\n\n## Options\n\n- [ ] **ghCompatibleHeaderId** (removal)\n\n Will be removed and **will become the default behavior**.\n \n- [ ] **customizedHeaderId** (removal)\n\n This option introduced non compliant syntax so it really belongs in an extension.\n The new **listener extension system** allows users to directly modify and customize\n the HTML and add any attributes they wish. \n\n- [ ] **rawPrefixHeaderId** (removal)\n\n This option will be superseeded by the option `rawHeaderId`. So basically activating `rawHeaderId` will make\n showdown only to replace spaces, ', \", > and < with dashes (-) from generated header ids, including prefixes.\n\n- [X] **literalMidWordAsterisks** (removal)\n\n This option is weird, hard to maintain and really... makes little sense.\n\n- [X] **excludeTrailingPunctuationFromURLs** (removal)\n\n This option will be removed and will be the default behavior from now on.\n\n- [ ] **strikethrough** (change)\n\n Will be enabled by default\n\n- [ ] **disableForced4SpacesIndentedSublists** (to think/postpone)\n\n This was only a temporary option for backwards compatibility reason. However, most flavours support lists indented\n with 2 spaces, so it puts us in a tight spot, specially since some markdown beautifiers out there insist in\n indenting lists with 2 spaces, probably in a misguided try to follow the CommonMark spec.\n \n The CommonMark spec is, IMHO, a bit confusing for users regarding this, since list sub-blocks (and lists) \n are determined by the spaces from the start of the line and the first character after the list mark. And the proof\n are the MD beautifiers out there, which misinterpreted the spec and made a mess \n \n Showdown syntax is actually easier (and fully compliant with the original spec): if you indent something 4 spaces,\n it becomes a sub-block. Since lists are blocks, you must indent it 4 spaces for it to become a sub-block.\n \n Regardless, we kinda have 2 solutions:\n \n - Drop support for 2 space indentation (and make a lot of users confused since GFM, CommonMark and others allow this)\n - Create a new list subparser that can be turned on with an option, like gfmListStyle\n (but postpones even more the alpha 3.0 release since the list subparser is probably the hardest thing to rewrite)\n \n Tough choices...\n\n- [ ] **simpleLineBreaks** (change)\n\n Will be removed from Github Flavor since github only does this in comments (which is weird...)\n\n- [ ] **openLinksInNewWindow** (removal)\n\n Will be removed in favor of the new listener extension, which will allow users to manipulate HTML tags attributes\n directly.\n \n- [ ] Revamp the option system\n\n Revamp the option system so that it becomes more simple. Right now, it's really confusing. And option names are weird\n too. The idea is to pass options to the constructor under an option object, that can have hierarchical structure.\n Ex:\n \n ```js\n var conv = new showdown.Converter({ \n options: { \n links: {\n autoLinks: true\n },\n headings: {\n startLevel: 2\n }\n }\n });\n ``` \n\n## Legacy Code Removal\n- [ ] Legacy extension support\n \n Old extensions that inject directly into extensions object property will no longer be supported\n \n- [ ] HTML and OUTPUT extensions\n \n HTML and OTP extensions will be dropped in favor of Listener Extensions. We might even give them a new name\n \n## Subparsers\n- [X] **Anchors**: Revamp the anchors subparser so it calls strikethrough, bold, italic and underline directly\n- [X] **autoLinks**: Fix some lingering bugs and issues with autolinks\n\n## Priority Bugs\n- [X] **#355**: *simplifiedAutoLink URLs inside parenthesis followed by another character are not parsed correctly*\n- [X] **#534**: *Multiple parentheses () in url link is not parsed correctly*\n- [ ] **#367**: *sublists rendering with 2 spaces* - related to disableForced4SpacesIndentedSublists option...\n- [ ] **#537**: *master branch doesn't work in a web worker*\n\n## CLI\n- [ ] Refactor the CLI\n- [ ] **#381**: *Support for src and dst directories in showdown cli*\n- [X] **#584**: *Fails to read from stdin*\n- [X] **#554**: *CLI not working with jsdom v10*\n\n## Other stuff\n- [X] Regexp rewrite for more performance oompf\n- [X] Full unit testing\n- [ ] Better error reporting\n\n## Stuff that probably won't make it to v2.0\n- [ ] **#486**: *A backslash at the end of the line is a hard line break*\n- [ ] **#548**: *anchors and images of subParser are errors when they are specific strings*\n- [ ] **#549**: *Strange parsing issue with ``*\n- [ ] Rethink the global variable\n\n## NEW Features\n\n### Event system\n- [X] Listener system revamp\n- [ ] Standardize events for all event types\n- [ ] Unit testing\n- [ ] Functional testing\n\nThis should address:\n- **#567**: Allow not making header ids lowercase\n- **#540**: Add complete class to the tasklist list element\n\n### MD to HTML conversion\n- [X] Basic support\n- [X] Basic functional testcase\n- [ ] Advanced support for all showdown MD features\n- [ ] Advanced functional testcase\n- [ ] Unit testing\n\n## Documentation (for v2.0)\n- [ ] Options\n- [ ] Extensions (and the new event system)\n- [ ] Cookbook (with stuff for backwards compatibility, specially regarding removed options)\n\n## Browser Testing\n\n- [X] Implement unit tests in Karma\n- [ ] Implement functional tests in Karma\n- [ ] Integrate with browserstack\n"
},
{
"path": "bin/showdown.js",
"content": "#!/usr/bin/env node\nvar showdown,version,fs=require(\"fs\"),path=require(\"path\"),Command=require(\"commander\").Command,program=new Command,path1=path.resolve(__dirname+\"/../dist/showdown.js\"),path2=path.resolve(__dirname+\"/../../.build/showdown.js\");function Messenger(o,t,e){\"use strict\";t=!!t||!!e,e=!!e,this._print=\"stdout\"===(o=o||\"stderr\")?console.log:console.error,this.errorExit=function(o){e||(console.error(\"ERROR: \"+o.message),console.error(\"Run 'showdown
(GFM Style)',\n type: 'boolean'\n },\n requireSpaceBeforeHeadingText: {\n defaultValue: false,\n describe: 'Makes adding a space between `#` and the header text mandatory (GFM Style)',\n type: 'boolean'\n },\n ghMentions: {\n defaultValue: false,\n describe: 'Enables github @mentions',\n type: 'boolean'\n },\n ghMentionsLink: {\n defaultValue: 'https://github.com/{u}',\n describe: 'Changes the link generated by @mentions. Only applies if ghMentions option is enabled.',\n type: 'string'\n },\n encodeEmails: {\n defaultValue: true,\n describe: 'Encode e-mail addresses through the use of Character Entities, transforming ASCII e-mail addresses into its equivalent decimal entities',\n type: 'boolean'\n },\n openLinksInNewWindow: {\n defaultValue: false,\n describe: 'Open all links in new windows',\n type: 'boolean'\n },\n backslashEscapesHTMLTags: {\n defaultValue: false,\n describe: 'Support for HTML Tag escaping. ex: \\>t<>\", \"<\", \">\", \"g\")\n * returns: [\"t<\", \"\"]\n * matchRecursiveRegExp(\"![](\"https://github.githubassets.com/images/icons/emoji/atom.png?v8\"){kind=icon}
',\n 'basecamp': '![](\"https://github.githubassets.com/images/icons/emoji/basecamp.png?v8\"){kind=icon}
',\n 'basecampy': '![](\"https://github.githubassets.com/images/icons/emoji/basecampy.png?v8\"){kind=icon}
',\n 'bowtie': '![](\"https://github.githubassets.com/images/icons/emoji/bowtie.png?v8\"){kind=icon}
',\n 'electron': '![](\"https://github.githubassets.com/images/icons/emoji/electron.png?v8\"){kind=icon}
',\n 'feelsgood': '![](\"https://github.githubassets.com/images/icons/emoji/feelsgood.png?v8\"){kind=icon}
',\n 'finnadie': '![](\"https://github.githubassets.com/images/icons/emoji/finnadie.png?v8\"){kind=icon}
',\n 'goberserk': '![](\"https://github.githubassets.com/images/icons/emoji/goberserk.png?v8\"){kind=icon}
',\n 'godmode': '![](\"https://github.githubassets.com/images/icons/emoji/godmode.png?v8\"){kind=icon}
',\n 'hurtrealbad': '![](\"https://github.githubassets.com/images/icons/emoji/hurtrealbad.png?v8\"){kind=icon}
',\n 'neckbeard': '![](\"https://github.githubassets.com/images/icons/emoji/neckbeard.png?v8\"){kind=icon}
',\n 'octocat': '![](\"https://github.githubassets.com/images/icons/emoji/octocat.png?v8\"){kind=icon}
',\n 'rage1': '![](\"https://github.githubassets.com/images/icons/emoji/rage1.png?v8\"){kind=icon}
',\n 'rage2': '![](\"https://github.githubassets.com/images/icons/emoji/rage2.png?v8\"){kind=icon}
',\n 'rage3': '![](\"https://github.githubassets.com/images/icons/emoji/rage3.png?v8\"){kind=icon}
',\n 'rage4': '![](\"https://github.githubassets.com/images/icons/emoji/rage4.png?v8\"){kind=icon}
',\n 'shipit': '![](\"https://github.githubassets.com/images/icons/emoji/shipit.png?v8\"){kind=icon}
',\n 'suspect': '![](\"https://github.githubassets.com/images/icons/emoji/suspect.png?v8\"){kind=icon}
',\n 'trollface': '![](\"https://github.githubassets.com/images/icons/emoji/trollface.png?v8\"){kind=icon}
',\n 'showdown': ''\n};\n\n/**\n * These are all the transformations that form block-level\n * tags like paragraphs, headers, and list items.\n */\nshowdown.subParser('makehtml.blockGamut', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.blockGamut.before', text, options, globals).getText();\n\n // we parse blockquotes first so that we can have headings and hrs\n // inside blockquotes\n text = showdown.subParser('makehtml.blockQuotes')(text, options, globals);\n text = showdown.subParser('makehtml.headers')(text, options, globals);\n\n // Do Horizontal Rules:\n text = showdown.subParser('makehtml.horizontalRule')(text, options, globals);\n\n text = showdown.subParser('makehtml.lists')(text, options, globals);\n text = showdown.subParser('makehtml.codeBlocks')(text, options, globals);\n text = showdown.subParser('makehtml.tables')(text, options, globals);\n\n // We already ran _HashHTMLBlocks() before, in Markdown(), but that\n // was to escape raw HTML in the original Markdown source. This time,\n // we're escaping the markup we've just created, so that we don't wrap\n //
content, so we need to fix that:\n bq = bq.replace(/(\\s*
[^\\r]+?<\\/pre>)/gm, function (wholeMatch, m1) {\n var pre = m1;\n // attacklab: hack around Konqueror 3.5.4 bug:\n pre = pre.replace(/^ /mg, '¨0');\n pre = pre.replace(/¨0/g, '');\n return pre;\n });\n\n return showdown.subParser('makehtml.hashBlock')('\\n' + bq + '\\n
', options, globals);\n });\n\n text = globals.converter._dispatch('makehtml.blockQuotes.after', text, options, globals).getText();\n return text;\n});\n\n/**\n * Process Markdown `
';\n\n codeblock = showdown.subParser('makehtml.hashBlock')(codeblock, options, globals);\n\n // Since GHCodeblocks can be false positives, we need to\n // store the primitive text and the parsed text in a global var,\n // and then return a token\n return '\\n\\n¨G' + (globals.ghCodeBlocks.push({text: wholeMatch, codeblock: codeblock}) - 1) + 'G\\n\\n';\n });\n\n // attacklab: strip sentinel\n text = text.replace(/¨0/, '');\n\n return globals.converter._dispatch('makehtml.githubCodeBlocks.after', text, options, globals).getText();\n});\n\nshowdown.subParser('makehtml.hashBlock', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.hashBlock.before', text, options, globals).getText();\n text = text.replace(/(^\\n+|\\n+$)/g, '');\n text = '\\n\\n¨K' + (globals.gHtmlBlocks.push(text) - 1) + 'K\\n\\n';\n text = globals.converter._dispatch('makehtml.hashBlock.after', text, options, globals).getText();\n return text;\n});\n\n/**\n * Hash and escape ` blocks.\n */\nshowdown.subParser('makehtml.codeBlocks', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.codeBlocks.before', text, options, globals).getText();\n\n // sentinel workarounds for lack of \\A and \\Z, safari\\khtml bug\n text += '¨0';\n\n var pattern = /(?:\\n\\n|^)((?:(?:[ ]{4}|\\t).*\\n+)+)(\\n*[ ]{0,3}[^ \\t\\n]|(?=¨0))/g;\n text = text.replace(pattern, function (wholeMatch, m1, m2) {\n var codeblock = m1,\n nextChar = m2,\n end = '\\n';\n\n codeblock = showdown.subParser('makehtml.outdent')(codeblock, options, globals);\n codeblock = showdown.subParser('makehtml.encodeCode')(codeblock, options, globals);\n codeblock = showdown.subParser('makehtml.detab')(codeblock, options, globals);\n codeblock = codeblock.replace(/^\\n+/g, ''); // trim leading newlines\n codeblock = codeblock.replace(/\\n+$/g, ''); // trim trailing newlines\n\n if (options.omitExtraWLInCodeBlocks) {\n end = '';\n }\n\n codeblock = '
';\n\n return showdown.subParser('makehtml.hashBlock')(codeblock, options, globals) + nextChar;\n });\n\n // strip sentinel\n text = text.replace(/¨0/, '');\n\n text = globals.converter._dispatch('makehtml.codeBlocks.after', text, options, globals).getText();\n return text;\n});\n\n/**\n *\n * * Backtick quotes are used for ' + codeblock + end + ' spans.\n *\n * * You can use multiple backticks as the delimiters if you want to\n * include literal backticks in the code span. So, this input:\n *\n * Just type ``foo `bar` baz`` at the prompt.\n *\n * Will translate to:\n *\n * foo `bar` baz at the prompt.`bar` ...\n */\nshowdown.subParser('makehtml.codeSpans', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.codeSpans.before', text, options, globals).getText();\n\n if (typeof (text) === 'undefined') {\n text = '';\n }\n text = text.replace(/(^|[^\\\\])(`+)([^\\r]*?[^`])\\2(?!`)/gm,\n function (wholeMatch, m1, m2, m3) {\n var c = m3;\n c = c.replace(/^([ \\t]*)/g, '');\t// leading whitespace\n c = c.replace(/[ \\t]*$/g, '');\t// trailing whitespace\n c = showdown.subParser('makehtml.encodeCode')(c, options, globals);\n c = m1 + '' + c + '';\n c = showdown.subParser('makehtml.hashHTMLSpans')(c, options, globals);\n return c;\n }\n );\n\n text = globals.converter._dispatch('makehtml.codeSpans.after', text, options, globals).getText();\n return text;\n});\n\n/**\n * Create a full HTML document from the processed markdown\n */\nshowdown.subParser('makehtml.completeHTMLDocument', function (text, options, globals) {\n 'use strict';\n\n if (!options.completeHTMLDocument) {\n return text;\n }\n\n text = globals.converter._dispatch('makehtml.completeHTMLDocument.before', text, options, globals).getText();\n\n var doctype = 'html',\n doctypeParsed = '\\n',\n title = '',\n charset = '\\n',\n lang = '',\n metadata = '';\n\n if (typeof globals.metadata.parsed.doctype !== 'undefined') {\n doctypeParsed = '\\n';\n doctype = globals.metadata.parsed.doctype.toString().toLowerCase();\n if (doctype === 'html' || doctype === 'html5') {\n charset = '';\n }\n }\n\n for (var meta in globals.metadata.parsed) {\n if (globals.metadata.parsed.hasOwnProperty(meta)) {\n switch (meta.toLowerCase()) {\n case 'doctype':\n break;\n\n case 'title':\n title = ' elements that should not be parsed as markdown\n */\nshowdown.subParser('makehtml.hashCodeTags', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.hashCodeTags.before', text, options, globals).getText();\n\n var repFunc = function (wholeMatch, match, left, right) {\n var codeblock = left + showdown.subParser('makehtml.encodeCode')(match, options, globals) + right;\n return '¨C' + (globals.gHtmlSpans.push(codeblock) - 1) + 'C';\n };\n\n // Hash naked \n text = showdown.helper.replaceRecursiveRegExp(text, repFunc, '', 'gim');\n\n text = globals.converter._dispatch('makehtml.hashCodeTags.after', text, options, globals).getText();\n return text;\n});\n\nshowdown.subParser('makehtml.hashElement', function (text, options, globals) {\n 'use strict';\n\n return function (wholeMatch, m1) {\n var blockText = m1;\n\n // Undo double lines\n blockText = blockText.replace(/\\n\\n/g, '\\n');\n blockText = blockText.replace(/^\\n/, '');\n\n // strip trailing blank lines\n blockText = blockText.replace(/\\n+$/g, '');\n\n // Replace the element text with a marker (\"¨KxK\" where x is its key)\n blockText = '\\n\\n¨K' + (globals.gHtmlBlocks.push(blockText) - 1) + 'K\\n\\n';\n\n return blockText;\n };\n});\n\nshowdown.subParser('makehtml.hashHTMLBlocks', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.hashHTMLBlocks.before', text, options, globals).getText();\n\n var blockTags = [\n 'pre',\n 'div',\n 'h1',\n 'h2',\n 'h3',\n 'h4',\n 'h5',\n 'h6',\n 'blockquote',\n 'table',\n 'dl',\n 'ol',\n 'ul',\n 'script',\n 'noscript',\n 'form',\n 'fieldset',\n 'iframe',\n 'math',\n 'style',\n 'section',\n 'header',\n 'footer',\n 'nav',\n 'article',\n 'aside',\n 'address',\n 'audio',\n 'canvas',\n 'figure',\n 'hgroup',\n 'output',\n 'video',\n 'details',\n 'p'\n ],\n repFunc = function (wholeMatch, match, left, right) {\n var txt = wholeMatch;\n // check if this html element is marked as markdown\n // if so, it's contents should be parsed as markdown\n if (left.search(/\\bmarkdown\\b/) !== -1) {\n txt = left + globals.converter.makeHtml(match) + right;\n }\n return '\\n\\n¨K' + (globals.gHtmlBlocks.push(txt) - 1) + 'K\\n\\n';\n };\n\n if (options.backslashEscapesHTMLTags) {\n // encode backslash escaped HTML tags\n text = text.replace(/\\\\<(\\/?[^>]+?)>/g, function (wm, inside) {\n return '<' + inside + '>';\n });\n }\n\n // hash HTML Blocks\n for (var i = 0; i < blockTags.length; ++i) {\n\n var opTagPos,\n rgx1 = new RegExp('^ {0,3}(<' + blockTags[i] + '\\\\b[^>]*>)', 'im'),\n patLeft = '<' + blockTags[i] + '\\\\b[^>]*>',\n patRight = '';\n // 1. Look for the first position of the first opening HTML tag in the text\n while ((opTagPos = showdown.helper.regexIndexOf(text, rgx1)) !== -1) {\n\n // if the HTML tag is \\ escaped, we need to escape it and break\n\n\n //2. Split the text in that position\n var subTexts = showdown.helper.splitAtIndex(text, opTagPos),\n //3. Match recursively\n newSubText1 = showdown.helper.replaceRecursiveRegExp(subTexts[1], repFunc, patLeft, patRight, 'im');\n\n // prevent an infinite loop\n if (newSubText1 === subTexts[1]) {\n break;\n }\n text = subTexts[0].concat(newSubText1);\n }\n }\n // HR SPECIAL CASE\n text = text.replace(/(\\n {0,3}(<(hr)\\b([^<>])*?\\/?>)[ \\t]*(?=\\n{2,}))/g,\n showdown.subParser('makehtml.hashElement')(text, options, globals));\n\n // Special case for standalone HTML comments\n text = showdown.helper.replaceRecursiveRegExp(text, function (txt) {\n return '\\n\\n¨K' + (globals.gHtmlBlocks.push(txt) - 1) + 'K\\n\\n';\n }, '^ {0,3}', 'gm');\n\n // PHP and ASP-style processor instructions ( and <%...%>)\n text = text.replace(/\\n\\n( {0,3}<([?%])[^\\r]*?\\2>[ \\t]*(?=\\n{2,}))/g,\n showdown.subParser('makehtml.hashElement')(text, options, globals));\n\n text = globals.converter._dispatch('makehtml.hashHTMLBlocks.after', text, options, globals).getText();\n return text;\n});\n\n/**\n * Hash span elements that should not be parsed as markdown\n */\nshowdown.subParser('makehtml.hashHTMLSpans', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.hashHTMLSpans.before', text, options, globals).getText();\n\n // Hash Self Closing tags\n text = text.replace(/<[^>]+?\\/>/gi, function (wm) {\n return showdown.helper._hashHTMLSpan(wm, globals);\n });\n\n // Hash tags without properties\n text = text.replace(/<([^>]+?)>[\\s\\S]*?<\\/\\1>/g, function (wm) {\n return showdown.helper._hashHTMLSpan(wm, globals);\n });\n\n // Hash tags with properties\n text = text.replace(/<([^>]+?)\\s[^>]+?>[\\s\\S]*?<\\/\\1>/g, function (wm) {\n return showdown.helper._hashHTMLSpan(wm, globals);\n });\n\n // Hash self closing tags without />\n text = text.replace(/<[^>]+?>/gi, function (wm) {\n return showdown.helper._hashHTMLSpan(wm, globals);\n });\n\n text = globals.converter._dispatch('makehtml.hashHTMLSpans.after', text, options, globals).getText();\n return text;\n});\n\n/**\n * Unhash HTML spans\n */\nshowdown.subParser('makehtml.unhashHTMLSpans', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.unhashHTMLSpans.before', text, options, globals).getText();\n\n for (var i = 0; i < globals.gHtmlSpans.length; ++i) {\n var repText = globals.gHtmlSpans[i],\n // limiter to prevent infinite loop (assume 10 as limit for recurse)\n limit = 0;\n\n while (/¨C(\\d+)C/.test(repText)) {\n var num = RegExp.$1;\n repText = repText.replace('¨C' + num + 'C', globals.gHtmlSpans[num]);\n if (limit === 10) {\n console.error('maximum nesting of 10 spans reached!!!');\n break;\n }\n ++limit;\n }\n text = text.replace('¨C' + i + 'C', repText);\n }\n\n text = globals.converter._dispatch('makehtml.unhashHTMLSpans.after', text, options, globals).getText();\n return text;\n});\n\n/**\n * Hash and escape elements that should not be parsed as markdown\n */\nshowdown.subParser('makehtml.hashPreCodeTags', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.hashPreCodeTags.before', text, options, globals).getText();\n\n var repFunc = function (wholeMatch, match, left, right) {\n // encode html entities\n var codeblock = left + showdown.subParser('makehtml.encodeCode')(match, options, globals) + right;\n return '\\n\\n¨G' + (globals.ghCodeBlocks.push({text: wholeMatch, codeblock: codeblock}) - 1) + 'G\\n\\n';\n };\n\n // Hash
', 'gim');\n\n text = globals.converter._dispatch('makehtml.hashPreCodeTags.after', text, options, globals).getText();\n return text;\n});\n\nshowdown.subParser('makehtml.headers', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.headers.before', text, options, globals).getText();\n\n var headerLevelStart = (isNaN(parseInt(options.headerLevelStart))) ? 1 : parseInt(options.headerLevelStart),\n\n // Set text-style headers:\n //\tHeader 1\n //\t========\n //\n //\tHeader 2\n //\t--------\n //\n setextRegexH1 = (options.smoothLivePreview) ? /^(.+)[ \\t]*\\n={2,}[ \\t]*\\n+/gm : /^(.+)[ \\t]*\\n=+[ \\t]*\\n+/gm,\n setextRegexH2 = (options.smoothLivePreview) ? /^(.+)[ \\t]*\\n-{2,}[ \\t]*\\n+/gm : /^(.+)[ \\t]*\\n-+[ \\t]*\\n+/gm;\n\n text = text.replace(setextRegexH1, function (wholeMatch, m1) {\n\n var spanGamut = showdown.subParser('makehtml.spanGamut')(m1, options, globals),\n hID = (options.noHeaderId) ? '' : ' id=\"' + headerId(m1) + '\"',\n hLevel = headerLevelStart,\n hashBlock = '\n text = showdown.helper.replaceRecursiveRegExp(text, repFunc, '^ {0,3}\\\\s*
tags.\n *\n * Any 3 or more unindented consecutive hyphens, asterisks or underscores with or without a space beetween them\n * in a single line is considered a horizontal rule\n */\nshowdown.subParser('makehtml.horizontalRule', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.horizontalRule.before', text, options, globals).getText();\n\n var key = showdown.subParser('makehtml.hashBlock')('
', options, globals);\n text = text.replace(/^ {0,2}( ?-){3,}[ \\t]*$/gm, key);\n text = text.replace(/^ {0,2}( ?\\*){3,}[ \\t]*$/gm, key);\n text = text.replace(/^ {0,2}( ?_){3,}[ \\t]*$/gm, key);\n\n text = globals.converter._dispatch('makehtml.horizontalRule.after', text, options, globals).getText();\n return text;\n});\n\n/**\n * Turn Markdown image shortcuts into tags.\n */\nshowdown.subParser('makehtml.images', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.images.before', text, options, globals).getText();\n\n var inlineRegExp = /!\\[([^\\]]*?)][ \\t]*()\\([ \\t]??(?: =([*\\d]+[A-Za-z%]{0,4})x([*\\d]+[A-Za-z%]{0,4}))?[ \\t]*(?:([\"'])([^\"]*?)\\6)?[ \\t]?\\)/g,\n crazyRegExp = /!\\[([^\\]]*?)][ \\t]*()\\([ \\t]?<([^>]*)>(?: =([*\\d]+[A-Za-z%]{0,4})x([*\\d]+[A-Za-z%]{0,4}))?[ \\t]*(?:(?:([\"'])([^\"]*?)\\6))?[ \\t]?\\)/g,\n base64RegExp = /!\\[([^\\]]*?)][ \\t]*()\\([ \\t]??(?: =([*\\d]+[A-Za-z%]{0,4})x([*\\d]+[A-Za-z%]{0,4}))?[ \\t]*(?:([\"'])([^\"]*?)\\6)?[ \\t]?\\)/g,\n referenceRegExp = /!\\[([^\\]]*?)] ?(?:\\n *)?\\[([\\s\\S]*?)]()()()()()/g,\n refShortcutRegExp = /!\\[([^\\[\\]]+)]()()()()()/g;\n\n function writeImageTagBase64 (wholeMatch, altText, linkId, url, width, height, m5, title) {\n url = url.replace(/\\s/g, '');\n return writeImageTag (wholeMatch, altText, linkId, url, width, height, m5, title);\n }\n\n function writeImageTagBaseUrl (wholeMatch, altText, linkId, url, width, height, m5, title) {\n url = showdown.helper.applyBaseUrl(options.relativePathBaseUrl, url);\n\n return writeImageTag (wholeMatch, altText, linkId, url, width, height, m5, title);\n }\n\n function writeImageTag (wholeMatch, altText, linkId, url, width, height, m5, title) {\n\n var gUrls = globals.gUrls,\n gTitles = globals.gTitles,\n gDims = globals.gDimensions;\n\n linkId = linkId.toLowerCase();\n\n if (!title) {\n title = '';\n }\n // Special case for explicit empty url\n if (wholeMatch.search(/\\(? ?(['\"].*['\"])?\\)$/m) > -1) {\n url = '';\n\n } else if (url === '' || url === null) {\n if (linkId === '' || linkId === null) {\n // lower-case and turn embedded newlines into spaces\n linkId = altText.toLowerCase().replace(/ ?\\n/g, ' ');\n }\n url = '#' + linkId;\n\n if (!showdown.helper.isUndefined(gUrls[linkId])) {\n url = gUrls[linkId];\n if (!showdown.helper.isUndefined(gTitles[linkId])) {\n title = gTitles[linkId];\n }\n if (!showdown.helper.isUndefined(gDims[linkId])) {\n width = gDims[linkId].width;\n height = gDims[linkId].height;\n }\n } else {\n return wholeMatch;\n }\n }\n\n altText = altText\n .replace(/\"/g, '"')\n //altText = showdown.helper.escapeCharacters(altText, '*_', false);\n .replace(showdown.helper.regexes.asteriskDashTildeAndColon, showdown.helper.escapeCharactersCallback);\n //url = showdown.helper.escapeCharacters(url, '*_', false);\n url = url.replace(showdown.helper.regexes.asteriskDashTildeAndColon, showdown.helper.escapeCharactersCallback);\n var result = '
x
- - - a
tags\n\n for (var i = 0; i < end; i++) {\n var str = grafs[i];\n // if this is an HTML marker, copy it\n if (str.search(/¨([KG])(\\d+)\\1/g) >= 0) {\n grafsOut.push(str);\n\n // test for presence of characters to prevent empty lines being parsed\n // as paragraphs (resulting in undesired extra empty paragraphs)\n } else if (str.search(/\\S/) >= 0) {\n str = showdown.subParser('makehtml.spanGamut')(str, options, globals);\n str = str.replace(/^([ \\t]*)/g, '
');\n str += '
';\n grafsOut.push(str);\n }\n }\n item = grafsOut.join('\\n');\n // Strip leading and trailing lines:\n item = item.replace(/^\\n+/g, '');\n item = item.replace(/\\n+$/g, '');\n\n } else {\n\n // Recursion for sub-lists:\n item = showdown.subParser('makehtml.lists')(item, options, globals);\n item = item.replace(/\\n$/, ''); // chomp(item)\n item = showdown.subParser('makehtml.hashHTMLBlocks')(item, options, globals);\n\n // Colapse double linebreaks\n item = item.replace(/\\n\\n+/g, '\\n\\n');\n\n if (isParagraphed) {\n item = showdown.subParser('makehtml.paragraphs')(item, options, globals);\n } else {\n item = showdown.subParser('makehtml.spanGamut')(item, options, globals);\n }\n }\n\n // now we need to remove the marker (¨A)\n item = item.replace('¨A', '');\n // we can finally wrap the line in list item tags\n item = 'tags\n\n for (var i = 0; i < end; i++) {\n var str = grafs[i];\n // if this is an HTML marker, copy it\n if (str.search(/¨(K|G)(\\d+)\\1/g) >= 0) {\n grafsOut.push(str);\n\n // test for presence of characters to prevent empty lines being parsed\n // as paragraphs (resulting in undesired extra empty paragraphs)\n } else if (str.search(/\\S/) >= 0) {\n str = showdown.subParser('makehtml.spanGamut')(str, options, globals);\n str = str.replace(/^([ \\t]*)/g, '
');\n str += '
';\n grafsOut.push(str);\n }\n }\n\n /** Unhashify HTML blocks */\n end = grafsOut.length;\n for (i = 0; i < end; i++) {\n var blockText = '',\n grafsOutIt = grafsOut[i],\n codeFlag = false;\n // if this is a marker for an html block...\n // use RegExp.test instead of string.search because of QML bug\n while (/¨(K|G)(\\d+)\\1/.test(grafsOutIt)) {\n var delim = RegExp.$1,\n num = RegExp.$2;\n\n if (delim === 'K') {\n blockText = globals.gHtmlBlocks[num];\n } else {\n // we need to check if ghBlock is a false positive\n if (codeFlag) {\n // use encoded version of all text\n blockText = showdown.subParser('makehtml.encodeCode')(globals.ghCodeBlocks[num].text, options, globals);\n } else {\n blockText = globals.ghCodeBlocks[num].codeblock;\n }\n }\n blockText = blockText.replace(/\\$/g, '$$$$'); // Escape any dollar signs\n\n grafsOutIt = grafsOutIt.replace(/(\\n\\n)?¨(K|G)\\d+\\2(\\n\\n)?/, blockText);\n // Check if grafsOutIt is a pre->code\n if (/^\\n');\n }\n } else {\n // Vanilla hard breaks\n text = text.replace(/ +\\n/g, '
\\n');\n }\n\n text = globals.converter._dispatch('makehtml.spanGamut.after', text, options, globals).getText();\n return text;\n});\n\nshowdown.subParser('makehtml.strikethrough', function (text, options, globals) {\n 'use strict';\n\n if (options.strikethrough) {\n text = globals.converter._dispatch('makehtml.strikethrough.before', text, options, globals).getText();\n text = text.replace(/(?:~){2}([\\s\\S]+?)(?:~){2}/g, function (wm, txt) { return '
' + globals.preList[num] + '';\n});\n\nshowdown.subParser('makeMarkdown.strikethrough', function (node, globals) {\n 'use strict';\n\n var txt = '';\n if (node.hasChildNodes()) {\n txt += '~~';\n var children = node.childNodes,\n childrenLength = children.length;\n for (var i = 0; i < childrenLength; ++i) {\n txt += showdown.subParser('makeMarkdown.node')(children[i], globals);\n }\n txt += '~~';\n }\n return txt;\n});\n\nshowdown.subParser('makeMarkdown.strong', function (node, globals) {\n 'use strict';\n\n var txt = '';\n if (node.hasChildNodes()) {\n txt += '**';\n var children = node.childNodes,\n childrenLength = children.length;\n for (var i = 0; i < childrenLength; ++i) {\n txt += showdown.subParser('makeMarkdown.node')(children[i], globals);\n }\n txt += '**';\n }\n return txt;\n});\n\nshowdown.subParser('makeMarkdown.table', function (node, globals) {\n 'use strict';\n\n var txt = '',\n tableArray = [[], []],\n headings = node.querySelectorAll('thead>tr>th'),\n rows = node.querySelectorAll('tbody>tr'),\n i, ii;\n for (i = 0; i < headings.length; ++i) {\n var headContent = showdown.subParser('makeMarkdown.tableCell')(headings[i], globals),\n allign = '---';\n\n if (headings[i].hasAttribute('style')) {\n var style = headings[i].getAttribute('style').toLowerCase().replace(/\\s/g, '');\n switch (style) {\n case 'text-align:left;':\n allign = ':---';\n break;\n case 'text-align:right;':\n allign = '---:';\n break;\n case 'text-align:center;':\n allign = ':---:';\n break;\n }\n }\n tableArray[0][i] = headContent.trim();\n tableArray[1][i] = allign;\n }\n\n for (i = 0; i < rows.length; ++i) {\n var r = tableArray.push([]) - 1,\n cols = rows[i].getElementsByTagName('td');\n\n for (ii = 0; ii < headings.length; ++ii) {\n var cellContent = ' ';\n if (typeof cols[ii] !== 'undefined') {\n cellContent = showdown.subParser('makeMarkdown.tableCell')(cols[ii], globals);\n }\n tableArray[r].push(cellContent);\n }\n }\n\n var cellSpacesCount = 3;\n for (i = 0; i < tableArray.length; ++i) {\n for (ii = 0; ii < tableArray[i].length; ++ii) {\n var strLen = tableArray[i][ii].length;\n if (strLen > cellSpacesCount) {\n cellSpacesCount = strLen;\n }\n }\n }\n\n for (i = 0; i < tableArray.length; ++i) {\n for (ii = 0; ii < tableArray[i].length; ++ii) {\n if (i === 1) {\n if (tableArray[i][ii].slice(-1) === ':') {\n tableArray[i][ii] = showdown.helper.padEnd(tableArray[i][ii].slice(0, -1), cellSpacesCount - 1, '-') + ':';\n } else {\n tableArray[i][ii] = showdown.helper.padEnd(tableArray[i][ii], cellSpacesCount, '-');\n }\n } else {\n tableArray[i][ii] = showdown.helper.padEnd(tableArray[i][ii], cellSpacesCount);\n }\n }\n txt += '| ' + tableArray[i].join(' | ') + ' |\\n';\n }\n\n return txt.trim();\n});\n\nshowdown.subParser('makeMarkdown.tableCell', function (node, globals) {\n 'use strict';\n\n var txt = '';\n if (!node.hasChildNodes()) {\n return '';\n }\n var children = node.childNodes,\n childrenLength = children.length;\n\n for (var i = 0; i < childrenLength; ++i) {\n txt += showdown.subParser('makeMarkdown.node')(children[i], globals, true);\n }\n return txt.trim();\n});\n\nshowdown.subParser('makeMarkdown.txt', function (node) {\n 'use strict';\n\n var txt = node.nodeValue;\n\n // multiple spaces are collapsed\n txt = txt.replace(/ +/g, ' ');\n\n // replace the custom ¨NBSP; with a space\n txt = txt.replace(/¨NBSP;/g, ' ');\n\n // \", <, > and & should replace escaped html entities\n txt = showdown.helper.unescapeHTMLEntities(txt);\n\n // escape markdown magic characters\n // emphasis, strong and strikethrough - can appear everywhere\n // we also escape pipe (|) because of tables\n // and escape ` because of code blocks and spans\n txt = txt.replace(/([*_~|`])/g, '\\\\$1');\n\n // escape > because of blockquotes\n txt = txt.replace(/^(\\s*)>/g, '\\\\$1>');\n\n // hash character, only troublesome at the beginning of a line because of headers\n txt = txt.replace(/^#/gm, '\\\\#');\n\n // horizontal rules\n txt = txt.replace(/^(\\s*)([-=]{3,})(\\s*)$/, '$1\\\\$2$3');\n\n // dot, because of ordered lists, only troublesome at the beginning of a line when preceded by an integer\n txt = txt.replace(/^( {0,3}\\d+)\\./gm, '$1\\\\.');\n\n // +, * and -, at the beginning of a line becomes a list, so we need to escape them also (asterisk was already escaped)\n txt = txt.replace(/^( {0,3})([+-])/gm, '$1\\\\$2');\n\n // images and links, ] followed by ( is problematic, so we escape it\n txt = txt.replace(/]([\\s]*)\\(/g, '\\\\]$1\\\\(');\n\n // reference URIs must also be escaped\n txt = txt.replace(/^ {0,3}\\[([\\S \\t]*?)]:/gm, '\\\\[$1]:');\n\n return txt;\n});\n\n/**\n * Created by Estevao on 31-05-2015.\n */\n\n/**\n * Showdown Converter class\n * @class\n * @param {object} [converterOptions]\n * @returns {Converter}\n */\nshowdown.Converter = function (converterOptions) {\n 'use strict';\n\n var\n /**\n * Options used by this converter\n * @private\n * @type {{}}\n */\n options = {},\n\n /**\n * Language extensions used by this converter\n * @private\n * @type {Array}\n */\n langExtensions = [],\n\n /**\n * Output modifiers extensions used by this converter\n * @private\n * @type {Array}\n */\n outputModifiers = [],\n\n /**\n * Event listeners\n * @private\n * @type {{}}\n */\n listeners = {},\n\n /**\n * The flavor set in this converter\n */\n setConvFlavor = setFlavor,\n\n /**\n * Metadata of the document\n * @type {{parsed: {}, raw: string, format: string}}\n */\n metadata = {\n parsed: {},\n raw: '',\n format: ''\n };\n\n _constructor();\n\n /**\n * Converter constructor\n * @private\n */\n function _constructor () {\n converterOptions = converterOptions || {};\n\n for (var gOpt in globalOptions) {\n if (globalOptions.hasOwnProperty(gOpt)) {\n options[gOpt] = globalOptions[gOpt];\n }\n }\n\n // Merge options\n if (typeof converterOptions === 'object') {\n for (var opt in converterOptions) {\n if (converterOptions.hasOwnProperty(opt)) {\n options[opt] = converterOptions[opt];\n }\n }\n } else {\n throw Error('Converter expects the passed parameter to be an object, but ' + typeof converterOptions +\n ' was passed instead.');\n }\n\n if (options.extensions) {\n showdown.helper.forEach(options.extensions, _parseExtension);\n }\n }\n\n /**\n * Parse extension\n * @param {*} ext\n * @param {string} [name='']\n * @private\n */\n function _parseExtension (ext, name) {\n\n name = name || null;\n // If it's a string, the extension was previously loaded\n if (showdown.helper.isString(ext)) {\n ext = showdown.helper.stdExtName(ext);\n name = ext;\n\n // LEGACY_SUPPORT CODE\n if (showdown.extensions[ext]) {\n console.warn('DEPRECATION WARNING: ' + ext + ' is an old extension that uses a deprecated loading method.' +\n 'Please inform the developer that the extension should be updated!');\n legacyExtensionLoading(showdown.extensions[ext], ext);\n return;\n // END LEGACY SUPPORT CODE\n\n } else if (!showdown.helper.isUndefined(extensions[ext])) {\n ext = extensions[ext];\n\n } else {\n throw Error('Extension \"' + ext + '\" could not be loaded. It was either not found or is not a valid extension.');\n }\n }\n\n if (typeof ext === 'function') {\n ext = ext();\n }\n\n if (!showdown.helper.isArray(ext)) {\n ext = [ext];\n }\n\n var validExt = validate(ext, name);\n if (!validExt.valid) {\n throw Error(validExt.error);\n }\n\n for (var i = 0; i < ext.length; ++i) {\n switch (ext[i].type) {\n\n case 'lang':\n langExtensions.push(ext[i]);\n break;\n\n case 'output':\n outputModifiers.push(ext[i]);\n break;\n }\n if (ext[i].hasOwnProperty('listeners')) {\n for (var ln in ext[i].listeners) {\n if (ext[i].listeners.hasOwnProperty(ln)) {\n listen(ln, ext[i].listeners[ln]);\n }\n }\n }\n }\n\n }\n\n /**\n * LEGACY_SUPPORT\n * @param {*} ext\n * @param {string} name\n */\n function legacyExtensionLoading (ext, name) {\n if (typeof ext === 'function') {\n ext = ext(new showdown.Converter());\n }\n if (!showdown.helper.isArray(ext)) {\n ext = [ext];\n }\n var valid = validate(ext, name);\n\n if (!valid.valid) {\n throw Error(valid.error);\n }\n\n for (var i = 0; i < ext.length; ++i) {\n switch (ext[i].type) {\n case 'lang':\n langExtensions.push(ext[i]);\n break;\n case 'output':\n outputModifiers.push(ext[i]);\n break;\n default:// should never reach here\n throw Error('Extension loader error: Type unrecognized!!!');\n }\n }\n }\n\n /**\n * Listen to an event\n * @param {string} name\n * @param {function} callback\n */\n function listen (name, callback) {\n if (!showdown.helper.isString(name)) {\n throw Error('Invalid argument in converter.listen() method: name must be a string, but ' + typeof name + ' given');\n }\n\n if (typeof callback !== 'function') {\n throw Error('Invalid argument in converter.listen() method: callback must be a function, but ' + typeof callback + ' given');\n }\n name = name.toLowerCase();\n if (!listeners.hasOwnProperty(name)) {\n listeners[name] = [];\n }\n listeners[name].push(callback);\n }\n\n function rTrimInputText (text) {\n var rsp = text.match(/^\\s*/)[0].length,\n rgx = new RegExp('^\\\\s{0,' + rsp + '}', 'gm');\n return text.replace(rgx, '');\n }\n\n /**\n *\n * @param {string} evtName Event name\n * @param {string} text Text\n * @param {{}} options Converter Options\n * @param {{}} globals Converter globals\n * @param {{}} [pParams] extra params for event\n * @returns showdown.helper.Event\n * @private\n */\n this._dispatch = function dispatch (evtName, text, options, globals, pParams) {\n evtName = evtName.toLowerCase();\n var params = pParams || {};\n params.converter = this;\n params.text = text;\n params.options = options;\n params.globals = globals;\n var event = new showdown.helper.Event(evtName, text, params);\n\n if (listeners.hasOwnProperty(evtName)) {\n for (var ei = 0; ei < listeners[evtName].length; ++ei) {\n var nText = listeners[evtName][ei](event);\n if (nText && typeof nText !== 'undefined') {\n event.setText(nText);\n }\n }\n }\n return event;\n };\n\n /**\n * Listen to an event\n * @param {string} name\n * @param {function} callback\n * @returns {showdown.Converter}\n */\n this.listen = function (name, callback) {\n listen(name, callback);\n return this;\n };\n\n /**\n * Converts a markdown string into HTML string\n * @param {string} text\n * @returns {*}\n */\n this.makeHtml = function (text) {\n //check if text is not falsy\n if (!text) {\n return text;\n }\n\n var globals = {\n gHtmlBlocks: [],\n gHtmlMdBlocks: [],\n gHtmlSpans: [],\n gUrls: {},\n gTitles: {},\n gDimensions: {},\n gListLevel: 0,\n hashLinkCounts: {},\n langExtensions: langExtensions,\n outputModifiers: outputModifiers,\n converter: this,\n ghCodeBlocks: [],\n metadata: {\n parsed: {},\n raw: '',\n format: ''\n }\n };\n\n // This lets us use ¨ trema as an escape char to avoid md5 hashes\n // The choice of character is arbitrary; anything that isn't\n // magic in Markdown will work.\n text = text.replace(/¨/g, '¨T');\n\n // Replace $ with ¨D\n // RegExp interprets $ as a special character\n // when it's in a replacement string\n text = text.replace(/\\$/g, '¨D');\n\n // Standardize line endings\n text = text.replace(/\\r\\n/g, '\\n'); // DOS to Unix\n text = text.replace(/\\r/g, '\\n'); // Mac to Unix\n\n // Stardardize line spaces\n text = text.replace(/\\u00A0/g, ' ');\n\n if (options.smartIndentationFix) {\n text = rTrimInputText(text);\n }\n\n // Make sure text begins and ends with a couple of newlines:\n text = '\\n\\n' + text + '\\n\\n';\n\n // detab\n text = showdown.subParser('makehtml.detab')(text, options, globals);\n\n /**\n * Strip any lines consisting only of spaces and tabs.\n * This makes subsequent regexs easier to write, because we can\n * match consecutive blank lines with /\\n+/ instead of something\n * contorted like /[ \\t]*\\n+/\n */\n text = text.replace(/^[ \\t]+$/mg, '');\n\n //run languageExtensions\n showdown.helper.forEach(langExtensions, function (ext) {\n text = showdown.subParser('makehtml.runExtension')(ext, text, options, globals);\n });\n\n // run the sub parsers\n text = showdown.subParser('makehtml.metadata')(text, options, globals);\n text = showdown.subParser('makehtml.hashPreCodeTags')(text, options, globals);\n text = showdown.subParser('makehtml.githubCodeBlocks')(text, options, globals);\n text = showdown.subParser('makehtml.hashHTMLBlocks')(text, options, globals);\n text = showdown.subParser('makehtml.hashCodeTags')(text, options, globals);\n text = showdown.subParser('makehtml.stripLinkDefinitions')(text, options, globals);\n text = showdown.subParser('makehtml.blockGamut')(text, options, globals);\n text = showdown.subParser('makehtml.unhashHTMLSpans')(text, options, globals);\n text = showdown.subParser('makehtml.unescapeSpecialChars')(text, options, globals);\n\n // attacklab: Restore dollar signs\n text = text.replace(/¨D/g, '$$');\n\n // attacklab: Restore tremas\n text = text.replace(/¨T/g, '¨');\n\n // render a complete html document instead of a partial if the option is enabled\n text = showdown.subParser('makehtml.completeHTMLDocument')(text, options, globals);\n\n // Run output modifiers\n showdown.helper.forEach(outputModifiers, function (ext) {\n text = showdown.subParser('makehtml.runExtension')(ext, text, options, globals);\n });\n\n // update metadata\n metadata = globals.metadata;\n return text;\n };\n\n /**\n * Converts an HTML string into a markdown string\n * @param src\n * @returns {string}\n */\n this.makeMarkdown = function (src) {\n\n // replace \\r\\n with \\n\n src = src.replace(/\\r\\n/g, '\\n');\n src = src.replace(/\\r/g, '\\n'); // old macs\n\n // due to an edge case, we need to find this: > <\n // to prevent removing of non silent white spaces\n // ex: this is sparta\n src = src.replace(/>[ \\t]+¨NBSP;<');\n\n var doc = showdown.helper.document.createElement('div');\n doc.innerHTML = src;\n\n var globals = {\n preList: substitutePreCodeTags(doc)\n };\n\n // remove all newlines and collapse spaces\n clean(doc);\n\n // some stuff, like accidental reference links must now be escaped\n // TODO\n // doc.innerHTML = doc.innerHTML.replace(/\\[[\\S\\t ]]/);\n\n var nodes = doc.childNodes,\n mdDoc = '';\n\n for (var i = 0; i < nodes.length; i++) {\n mdDoc += showdown.subParser('makeMarkdown.node')(nodes[i], globals);\n }\n\n function clean (node) {\n for (var n = 0; n < node.childNodes.length; ++n) {\n var child = node.childNodes[n];\n if (child.nodeType === 3) {\n if (!/\\S/.test(child.nodeValue) && !/^[ ]+$/.test(child.nodeValue)) {\n node.removeChild(child);\n --n;\n } else {\n child.nodeValue = child.nodeValue.split('\\n').join(' ');\n child.nodeValue = child.nodeValue.replace(/(\\s)+/g, '$1');\n }\n } else if (child.nodeType === 1) {\n clean(child);\n }\n }\n }\n\n // find all pre tags and replace contents with placeholder\n // we need this so that we can remove all indentation from html\n // to ease up parsing\n function substitutePreCodeTags (doc) {\n\n var pres = doc.querySelectorAll('pre'),\n presPH = [];\n\n for (var i = 0; i < pres.length; ++i) {\n\n if (pres[i].childElementCount === 1 && pres[i].firstChild.tagName.toLowerCase() === 'code') {\n var content = pres[i].firstChild.innerHTML.trim(),\n language = pres[i].firstChild.getAttribute('data-language') || '';\n\n // if data-language attribute is not defined, then we look for class language-*\n if (language === '') {\n var classes = pres[i].firstChild.className.split(' ');\n for (var c = 0; c < classes.length; ++c) {\n var matches = classes[c].match(/^language-(.+)$/);\n if (matches !== null) {\n language = matches[1];\n break;\n }\n }\n }\n\n // unescape html entities in content\n content = showdown.helper.unescapeHTMLEntities(content);\n\n presPH.push(content);\n pres[i].outerHTML = '
<div>foo</div>
\n ```\n\n### completeHTMLDocument\n\nOutput a complete HTML document, including ``, ``, and `` tags instead of an HTML fragment.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.8.5`\n\n### customizedHeaderId\n\nSet custom ID for a heading.\n\n!!! warning \"\"\n This option can be overridden with the [`noHeaderId`](#noheaderid) option.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.7.0`\n\n=== \"code\"\n\n ```html\n ## Sample heading {mycustomid}\n ```\n\n=== \"output\"\n\n ```html\nThis is a heading
\n ```\n\n!!! hint \"\"\n For better readability and human-friendliness of the heading IDs, it is also recommended to set the [`ghCompatibleHeaderId`](#ghcompatibleheaderid) option to `true`.\n\n### disableForced4SpacesIndentedSublists\n\nDisable the rule of 4 spaces to indent sub-lists. If enabled, this option effectively reverts to the old behavior where you can indent sub-lists with 2 or 3 spaces.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.5.0`\n\n=== \"input\"\n \n ```\n - one\n - two\n\n ...\n\n - one\n - two\n ```\n\n=== \"output (value is `false`)\"\n\n ```html\n- \n
- one \n
- two \n
...
\n- \n
- one\n
- \n
- two \n
\n
- \n
- one\n
- \n
- two \n
\n
...
\n- \n
- one\n
- \n
- two \n
\n
this is a :smile: emoji
\n ```\n\n=== \"output (value is `true`)\"\n\n ```html\nthis is a 😄 emoji
\n ```\n\n!!! hint \"Full list of supported emojies\"\n\n Check the [Showdown Wiki](https://github.com/showdownjs/showdown/wiki/Emojis#emoji-list) for a full list of supported emojies. \n\n### encodeEmails\n\nEnable automatic obfuscation of email addresses. During this process, email addresses are encoded via Character Entities, transforming ASCII email addresses into their equivalent decimal entities.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.6.1`\n\n=== \"input\"\n \n ```\ncheck this link www.google.com.
\n ```\n\n=== \"output (value is `true`)\"\n\n ```html\ncheck this link www.google.com.
\n ```\n\n### ghCodeBlocks\n\nEnable support for GFM code block style syntax (fenced codeblocks).\n\n* type: `boolean`\n* default value: `true`\n* introduced in: `0.3.1`\n\n=== \"example\"\n \n ```\n ```\n some code here\n\t ```\n ```\n\n### ghCompatibleHeaderId\n\nGenerate heading IDs compatible with GitHub style: spaces are replaced with dashes, and certain non-alphanumeric chars are removed.\n\n!!! warning \"\"\n This option can be overridden with the [`noHeaderId`](#noheaderid) option.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.5.5`\n\n=== \"input\"\n \n ```\n # This is a heading with @#$%\n ```\n\n=== \"output (value is `false`)\"\n\n ```html\nThis is a heading
\n ```\n\n=== \"output (value is `true`)\"\n\n ```html\nThis is a heading with @#$%
\n ```\n\n### ghMentions\n\nEnables support for GitHub `@mentions` that allows you to link to the GitHub profile page of the mentioned username.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.6.0` \n\n=== \"input\"\n \n ```\n hello there @tivie\n ```\n\n=== \"output (value is `false`)\"\n\n ```html\nhello there @tivie
\n ```\n\n=== \"output (value is `true`)\"\n\n ```html\nhello there @tivie
\n ```\n\n### ghMentionsLink\n\nSpecify where the link generated by `@mentions` should point to. Works only when [`ghMentions: true`](#ghmentions).\n\n* type: `boolean`\n* default value: `https://github.com/{u}`\n* introduced in: `1.6.2`\n\n=== \"input\"\n \n ```\n hello there @tivie\n ```\n\n=== \"output (value is `https://github.com/{u}`)\"\n\n ```html\nhello there @tivie
\n ```\n\n=== \"output (value is `http://mysite.com/{u}/profile`)\"\n\n ```html\nhello there @tivie
\n ```\n\n### headerLevelStart\n\nSet starting level for the heading tags.\n\n* type: `integer`\n* default value: `1`\n* introduced in: `1.1.0`\n\n=== \"input\"\n \n ```\n # This is a heading\n ```\n\n=== \"output (value is `1`)\"\n\n ```html\nThis is a heading
\n ```\n\n=== \"output (value is `3`)\"\n\n ```html\nThis is a heading
\n ```\n\n### literalMidWordUnderscores\n\nTreat underscores in the middle of words as literal characters.\n\nUnderscores allow you to specify the words that should be emphasized. However, in some cases, this may be unwanted behavior. With this option enabled, underscores in the middle of words will no longer be interpreted as `` and ``, but as literal underscores.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.2.0`\n\n=== \"input\"\n \n ```\n some text with__underscores__in the middle\n ```\n\n=== \"output (value is `false`)\"\n\n ```html\nsome text withunderscoresin the middle
\n ```\n\n=== \"output (value is `true`)\"\n\n ```html\nsome text with__underscores__in the middle
\n ```\n\n### metadata\n\nEnable support for document metadata (front-matter). You can define metadata at the top of a document between `««« »»»` or `--- ---` symbols.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.8.5`\n\n=== \"input\"\n \n ```js\n let ref = `referenced value`;\n\n var markdown = `\n ---\n first: Lorem\n second: Ipsum\n ref_variable: ${ref}\n ---\n `\n\n var conv = new showdown.Converter({metadata: true});\n var html = conv.makeHtml(markdown);\n var metadata = conv.getMetadata();\n ```\n\n=== \"output (value is `true`)\"\n\n ```js\n // console.log(metadata)\n {\n first: 'Lorem',\n second: 'Ipsum',\n ref_variable: 'referenced value'\n }\n ```\n\n### noHeaderId\n\nDisable automatic generation of heading IDs.\n\n!!! warning \"\"\n Setting the option to `true` overrides the following options:\n \n * [`prefixHeaderId`](#prefixheaderid)\n * [`customizedHeaderId`](#customizedheaderid)\n * [`ghCompatibleHeaderId`](#ghcompatibleheaderid)\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.1.0`\n\n=== \"input\"\n \n ```\n # This is a heading\n ```\n\n=== \"output (value is `false`)\"\n\n ```html\nThis is a heading
\n ```\n\n=== \"output (value is `true`)\"\n\n ```html\nThis is a heading
\n ```\n\n### omitExtraWLInCodeBlocks\n\nOmit trailing newline in code blocks (which is set by default before the closing tag). This option affects both indented and fenced (gfm style) code blocks.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.0.0`\n\n=== \"input\"\n \n ```\n var foo = 'bar';\n ```\n\n=== \"output (value is `false`)\"\n\n ```html\nvar foo = 'bar';\n
var foo = 'bar';
This is a heading
\n ```\n\n=== \"output (value is `true`)\"\n\n ```html\nThis is a heading
\n ```\n\n=== \"output (value is `showdown`)\"\n\n ```html\nThis is a heading
\n ```\n\n### rawHeaderId\n\nReplace ` ` (space), `'` (single quote), and `\"` (double quote) with `-` (dash) in the generated heading IDs, including prefixes.\n\n!!! danger \"\"\n **Use with caution** as it might result in malformed IDs.\n\n* type:\n* default value:\n* introduced in: `1.7.3`\n\n### rawPrefixHeaderId\n\nPrevent Showndown from modifying the prefix. Works only when [`prefixHeaderId`](#prefixheaderid) is set to a string value.\n\n!!! danger \"\"\n **Use with caution** as it might result in malformed IDs. For example, when the prefix contains special characters like `\"` `\\` `/` or others.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.7.3`\n\n### requireSpaceBeforeHeadingText\n\nRequire a space between a heading `#` and the heading text.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.5.3`\n\n=== \"input\"\n \n ```\n #heading\n ```\n\n=== \"output (value is `false`)\"\n\n ```html\nheading
\n ```\n\n=== \"output (value is `true`)\"\n\n ```html\n#heading
\n ```\n\n### simpleLineBreaks\n\nParse line breaks as `` in paragraphs (GitHub-style behavior).\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.5.1`\n\n=== \"input\"\n \n ```\n a line\n wrapped in two\n ```\n\n=== \"output (value is `false`)\"\n\n ```html\n
a line\n wrapped in two
\n ```\n\n=== \"output (value is `true`)\"\n\n ```html\na line
\n wrapped in two
Lorem ipsum www.google.com
\n ```\n\n=== \"output (value is `true`)\"\n\n ```html\nLorem ipsum www.google.com
\n ```\n\n### smartIndentationFix\n\nResolve indentation problems related to ES6 template strings in the midst of indented code.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.4.2`\n\n### smoothLivePreview\n\nResolve an awkward effect when a paragraph is followed by a list. This effect appears on some circumstances, in live preview editors.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.2.1`\n\n!!! example \"awkward effect\"\n \n \n\n### splitAdjacentBlockquotes\n\nSplit adjacent blockquote blocks.\n\n* type: `boolean`\n* default value: `false`\n* introduced in: `1.8.6`\n\n=== \"input\"\n \n ```\n > Quote #1\n >> Sub-quote 1\n\n > Quote #2\n >> Sub-quote 2\n ```\n\n=== \"output (value is `false`)\"\n\n ```html\n\n\n ```\n\n=== \"output (value is `true`)\"\n\n ```html\nQuote #1
\n\n\nSub-quote 1
\nQuote #2
\n\n\nSub-quote 2
\n
\n\nQuote #1
\n\n\nSub-quote 1
\n
\n\n ```\n\n### strikethrough\n\nEnable support for strikethrough (`Quote #2
\n\n\nSub-quote 2
\n
![](\"https://img.icons8.com/external-tal-revivo-color-tal-revivo/16/000000/external-firefox-a-free-and-open-source-web-browser-developed-by-the-mozilla-foundation-logo-color-tal-revivo.png\"/){kind=logo}
Firefox 1.5 and 2.0\n* ![](\"https://img.icons8.com/color/16/000000/chrome--v1.png\"/)
Chrome 12.0\n* ![](\"https://img.icons8.com/color/16/000000/internet-explorer.png\"/)
Internet Explorer 6 and 7\n* ![](\"https://img.icons8.com/color/16/000000/safari--v1.png\"/)
Safari 2.0.4\n* ![](\"https://img.icons8.com/color/16/000000/opera--v1.png\"/)
Opera 8.54 and 9.10\n* ![](\"https://img.icons8.com/color/16/000000/netscape.png\"/)
Netscape 8.1.2\n* ` in HTML) to a paragraph, \nyou can do so by adding 3 space characters to the end of the line.\n\nYou can also force every line break in paragraphs to translate to `
` (as Github does) by\nenabling the option [**`simpleLineBreaks`**][simpleLineBreaks].\n\n[simpleLineBreaks]: available-options.md#simplelinebreaks\n\n## Headings\n\n### Atx Style\n\nYou can create a heading by adding one or more `#` symbols before your heading text. The number of `#` determines the level of the heading. This is similar to [**atx style**][atx].\n\n```md\n# The 1st level heading (an
tag)\n## The 2nd level heading (an tag)\n…\n###### The 6th level heading (an tag)\n```\n\nThe space between `#` and the heading text is not required but you can make it mandatory by enabling the option [**`requireSpaceBeforeHeadingText`**][requireSpaceBeforeHeadingText].\n\n[requireSpaceBeforeHeadingText]: available-options.md#requirespacebeforeheadingtext\n\nYou can wrap the headings in `#`. Both leading and trailing `#` will be removed.\n\n```md\n## My Heading ##\n```\n\nIf, for some reason, you need to keep a leading or trailing `#`, you can either add a space or escape it:\n\n```md\n# # My header # #\n\n#\\# My Header \\# #\n```\n\n### Setext style\n\nYou can also use [**setext style**][setext] headings, although only two levels are available.\n\n```md\nThis is an H1\n=============\n \nThis is an H2\n-------------\n```\n\n!!! warning \"\"\n There is an awkward effect when a paragraph is followed by a list. This effect appears on some circumstances, in live preview editors.\n\n ![awkward effect][]\n\n You can prevent this by enabling the option [**`smoothPreview`**][smoothlivepreview].\n\n[smoothlivepreview]: available-options.md#smoothlivepreview\n\n### Header IDs\n\nShowdown automatically generates bookmark anchors in titles by adding an id property to a heading.\n\n```md\n# My cool header with ID\n```\n\n```html\nMy cool header with ID
\n```\n\nThis behavior can be modified with options:\n\n - [**`noHeaderId`**][noHeaderId] disables automatic id generation; \n - [**`ghCompatibleHeaderId`**][ghCompatibleHeaderId] generates header ids compatible with github style (spaces are replaced with dashes and a bunch of non alphanumeric chars are removed)\n - [**`prefixHeaderId`**][prefixHeaderId] adds a prefix to the generated header ids (either automatic or custom).\n - [**`headerLevelStart`**][headerLevelStart] sets the header starting level. For instance, setting this to 3 means that `# header` will be converted to ``.\n\nRead the [README.md][readme] for more info\n\n[noHeaderId]: available-options.md#noheaderid\n[ghCompatibleHeaderId]: available-options.md#ghcompatibleheaderid\n[prefixHeaderId]: available-options.md#prefixheaderid\n[headerLevelStart]: available-options.md#headerlevelstart\n\n## Blockquotes\n\nYou can indicate blockquotes with a `>`.\n\n```md\nIn the words of Abraham Lincoln:\n \n> Pardon my french\n```\n\nBlockquotes can have multiple paragraphs and can have other block elements inside.\n\n```md\n> A paragraph of text\n>\n> Another paragraph\n>\n> - A list\n> - with items\n```\n\n## Bold and Italic\n\nYou can make text bold or italic.\n\n```md\n*This text will be italic*\n**This text will be bold**\n```\n\nBoth bold and italic can use either a `*` or an `_` around the text for styling. This allows you to combine both bold and italic if needed.\n\n```md\n**Everyone _must_ attend the meeting at 5 o'clock today.**\n```\n\n## Strikethrough\n\nWith the option [**`strikethrough`**][] enabled, Showdown supports strikethrough elements.\nThe syntax is the same as GFM, that is, by adding two tilde (`~~`) characters around\na word or groups of words.\n\n```md\na ~~strikethrough~~ element\n```\n\na strikethrough element\n\n[strikethrough]: available-options.md#strikethrough\n\n## Emojis\n\nSince version 1.8.0, Showdown supports Github's emojis. A complete list of available emojis can be found [here][emoji list].\n\n```md\nthis is a :smile: smile emoji\n```\n\nthis is a :smile: smile emoji\n\n## Code formatting\n\n### Inline formats\n\nUse single backticks (`) to format text in a special monospace format. Everything within the backticks appear as-is, with no other special formatting.\n\n```md\nHere's an idea: why don't we take `SuperiorProject` and turn it into `**Reasonable**Project`.\n```\n\n```html\n
tag)\n```\n\nThe space between `#` and the heading text is not required but you can make it mandatory by enabling the option [**`requireSpaceBeforeHeadingText`**][requireSpaceBeforeHeadingText].\n\n[requireSpaceBeforeHeadingText]: available-options.md#requirespacebeforeheadingtext\n\nYou can wrap the headings in `#`. Both leading and trailing `#` will be removed.\n\n```md\n## My Heading ##\n```\n\nIf, for some reason, you need to keep a leading or trailing `#`, you can either add a space or escape it:\n\n```md\n# # My header # #\n\n#\\# My Header \\# #\n```\n\n### Setext style\n\nYou can also use [**setext style**][setext] headings, although only two levels are available.\n\n```md\nThis is an H1\n=============\n \nThis is an H2\n-------------\n```\n\n!!! warning \"\"\n There is an awkward effect when a paragraph is followed by a list. This effect appears on some circumstances, in live preview editors.\n\n ![awkward effect][]\n\n You can prevent this by enabling the option [**`smoothPreview`**][smoothlivepreview].\n\n[smoothlivepreview]: available-options.md#smoothlivepreview\n\n### Header IDs\n\nShowdown automatically generates bookmark anchors in titles by adding an id property to a heading.\n\n```md\n# My cool header with ID\n```\n\n```html\nMy cool header with ID
\n```\n\nThis behavior can be modified with options:\n\n - [**`noHeaderId`**][noHeaderId] disables automatic id generation; \n - [**`ghCompatibleHeaderId`**][ghCompatibleHeaderId] generates header ids compatible with github style (spaces are replaced with dashes and a bunch of non alphanumeric chars are removed)\n - [**`prefixHeaderId`**][prefixHeaderId] adds a prefix to the generated header ids (either automatic or custom).\n - [**`headerLevelStart`**][headerLevelStart] sets the header starting level. For instance, setting this to 3 means that `# header` will be converted to ``.\n\nRead the [README.md][readme] for more info\n\n[noHeaderId]: available-options.md#noheaderid\n[ghCompatibleHeaderId]: available-options.md#ghcompatibleheaderid\n[prefixHeaderId]: available-options.md#prefixheaderid\n[headerLevelStart]: available-options.md#headerlevelstart\n\n## Blockquotes\n\nYou can indicate blockquotes with a `>`.\n\n```md\nIn the words of Abraham Lincoln:\n \n> Pardon my french\n```\n\nBlockquotes can have multiple paragraphs and can have other block elements inside.\n\n```md\n> A paragraph of text\n>\n> Another paragraph\n>\n> - A list\n> - with items\n```\n\n## Bold and Italic\n\nYou can make text bold or italic.\n\n```md\n*This text will be italic*\n**This text will be bold**\n```\n\nBoth bold and italic can use either a `*` or an `_` around the text for styling. This allows you to combine both bold and italic if needed.\n\n```md\n**Everyone _must_ attend the meeting at 5 o'clock today.**\n```\n\n## Strikethrough\n\nWith the option [**`strikethrough`**][] enabled, Showdown supports strikethrough elements.\nThe syntax is the same as GFM, that is, by adding two tilde (`~~`) characters around\na word or groups of words.\n\n```md\na ~~strikethrough~~ element\n```\n\na strikethrough element\n\n[strikethrough]: available-options.md#strikethrough\n\n## Emojis\n\nSince version 1.8.0, Showdown supports Github's emojis. A complete list of available emojis can be found [here][emoji list].\n\n```md\nthis is a :smile: smile emoji\n```\n\nthis is a :smile: smile emoji\n\n## Code formatting\n\n### Inline formats\n\nUse single backticks (`) to format text in a special monospace format. Everything within the backticks appear as-is, with no other special formatting.\n\n```md\nHere's an idea: why don't we take `SuperiorProject` and turn it into `**Reasonable**Project`.\n```\n\n```html\n
Here's an idea: why don't we take SuperiorProject and turn it into **Reasonable**Project.
``` to format text as its own distinct block.\n\n Check out this neat program I wrote:\n\n ```\n x = 0\n x = 2 + 2\n what is x\n ```\n\n[ghCodeBlocks]: available-options.md#ghcodeblocks\n\n## Lists\n\nShowdown supports unordered (bulleted) and ordered (numbered) lists.\n\n### Unordered lists\n\nYou can make an unordered list by preceding list items with either `*`, `-`, or `+`. Markers are interchangeable too.\n\n```md\n* Item\n+ Item\n- Item\n```\n\n### Ordered lists\n\nYou can make an ordered list by preceding list items with a number.\n\n```md\n1. Item 1\n2. Item 2\n3. Item 3\n```\n\n!!! earning \"\"\n The actual numbers you use to mark the list have no effect on the HTML output that Showdown produces. So you can use the same number in all items if you wish to. For example:\n\n ```md\n 1. Item 1\n 1. Item 2\n 1. Item 3\n\n 2. Item 1\n 2. Item 2\n 2. Item 3\n ```\n\n### TaskLists (GFM Style)\n\nShowdown supports GFM-styled takslists if the [**`tasklists`**][tasklists] option is enabled.\n\n```md\n - [x] checked list item\n - [ ] unchecked list item\n``` \n\n - [x] checked list item\n - [ ] unchecked list item\n\n\n[tasklists]: available-options.md#tasklists\n\n### List syntax\n\nList markers typically start at the left margin, but may be indented by up to three spaces. \n\n```md\n* valid list item\n * this is valid too\n * this is too \n```\n\nList markers must be followed by one or more spaces or a tab.\n\nTo make lists look nicer, you can wrap items with hanging indents:\n\n```md\n* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.\n Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,\n viverra nec, fringilla in, laoreet vitae, risus.\n* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.\n Suspendisse id sem consectetuer libero luctus adipiscing.\n```\n\nBut if you want to be lazy, you don't have to :grin:\n\nIf one list item is separated by a blank line, Showdown will wrap all the list items in `` tags in the HTML output.\nSo this input:\n\n```md\n* Bird\n\n* Magic\n* Johnson\n```\n\nresults in:\n\n```html\n
- \n
Bird
\nMagic
\nJohnson
\n
hey @tivie, check this out
\n```\n\n[mentions]: available-options.md#ghmentions\n[ghMentionsLink]: available-options.md#ghmentionslink\n\n## Handle HTML in markdown documents\n\nShowdown, in most cases, leaves HTML tags untouched in the output document:\n\n```md\nsome markdown **here**\nsome markdown here
\n` and `` tags is always escaped.\n\n```md\nsome markdown **here** with foo & bar \n```\n\n```html\nsome markdown here with foo & bar <baz></baz>
\n``` \n\nIf you want to enable markdown parsing inside a specific HTML tag, you can use the html attribute **`markdown`**, **`markdown=\"1\"`**, or **`data-markdown=\"1\"`**.\n\n```md\nsome markdown **here**\nthis is *not* **parsed**\n```\n\n```html\nsome markdown here
\nthis is not parsed
\n```\n\n## Escape entities\n\n### Escape markdown entities\n\nShowdown allows you to use backslash (`\\`) to escape characters that have special meaning in markdown's syntax and generate literal characters instead. For example, if you want to surround a word with literal underscores (instead of an HTML `` tag), you can use backslashes before the underscores, like this:\n\n```md\n\\_literal underscores\\_\n```\n\nShowdown provides backslash escapes for the following characters:\n\n```\n\\ backslash\n` backtick\n* asterisk\n_ underscore\n{} curly braces\n[] square brackets\n() parentheses\n# hash mark\n+ plus sign\n- minus sign (hyphen)\n. dot\n! exclamation mark\n```\n\n### Escape HTML tags\n\nSince [version 1.7.2](https://github.com/showdownjs/showdown/tree/1.7.2), backslash escaping of HTML tags is supported when [**`backslashEscapesHTMLTags`**][backslashEscapesHTMLTags] option is enabled.\n\n```md\n\\a literal div\\\n``` \n\n[backslashEscapesHTMLTags]: available-options.md#backslashescapeshtmltags\n\n## Known differences and gotchas\n\nIn most cases, Showdown's output is identical to that of Perl Markdown v1.0.2b7. What follows is a list of all known deviations. Please file an issue if you find more.\n\n* **Since version 1.4.0, Showdown supports the markdown=\"1\" attribute**, but for older versions, this attribute is ignored. This means:\n\n ```md\n \n Markdown does *not* work in here.\n \n ```\n\n* You can only nest square brackets in link titles to a depth of two levels:\n\n [[fine]](http://www.github.com/)\n [[[broken]]](http://www.github.com/)\n\n If you need more, you can escape them with backslashes.\n\n* A list is **single paragraph** if it has only **1 line break separating items** and it becomes **multi-paragraph if ANY of its items is separated by 2 line breaks**:\n\n ```md\n - foo\n\n - bar\n - baz\n ```\n\n becomes\n\n ```html\n \n foo
bar
baz
\n ```\n\nThis new ruleset is based on the comments of Markdown's author John Gruber in the [Markdown discussion list][md-newsletter].\n\n[md-spec]: http://daringfireball.net/projects/markdown/\n[md-newsletter]: https://pairlist6.pair.net/mailman/listinfo/markdown-discuss\n[atx]: http://www.aaronsw.com/2002/atx/intro\n[setext]: https://en.wikipedia.org/wiki/Setext\n[readme]: https://github.com/showdownjs/showdown/blob/master/README.md\n[awkward effect]: http://i.imgur.com/YQ9iHTL.gif\n[emoji list]: https://github.com/showdownjs/showdown/wiki/emojis"
},
{
"path": "docs/quickstart.md",
"content": "To quickstart with Showdown, install it as a package (for server-side) or include it to your browser (client-side) via CDN:\n\n## Installation\n\n### Server-side\n\n=== \"npm\"\n\n ```\n npm install showdown\n ```\n\n=== \"bower\"\n\n ```\n bower install showdown\n ```\n\n=== \"NuGet\"\n\n ```\n PM> Install-Package showdownjs\n ```\n\n More information about the package you can find on the [NuGet website](https://www.nuget.org/packages/showdownjs/).\n\n### Client-side\n\n=== \"jsDelivr\"\n\n ```\n https://cdn.jsdelivr.net/npm/showdown@/dist/showdown.min.js\n ```\n \n [Showndown page on jsDelivr](https://www.jsdelivr.com/package/npm/showdown)\n\n=== \"cdnjs\"\n\n ```\n https://cdnjs.cloudflare.com/ajax/libs/showdown//showdown.min.js\n ```\n\n [Showndown page on cdnjs](https://cdnjs.com/libraries/showdown)\n\n=== \"unpkg\"\n\n ```\n https://unpkg.com/showdown/dist/showdown.min.js\n ```\n\n [Showndown page on unpkg](https://unpkg.com/browse/showdown@latest/)\n\n!!! note \"\"\n Replace `` with an actual full length version you're interested in. For example, `2.0.3`.\n\n## Usage\n\nOnce installed, you can use Showndown according to the chosen method:\n\n### Server-side\n\n!!! example \"Node.js\"\n\n === \"code\"\n\n ```js\n var showdown = require('showdown'),\n converter = new showdown.Converter(),\n text = '# hello, markdown!',\n html = converter.makeHtml(text);\n ```\n \n === \"output\"\n\n ```html\n hello, markdown!
\n ```\n\n### Client-side\n\n!!! example \"Browser\"\n\n === \"code\"\n\n ```js\n var converter = new showdown.Converter(),\n text = '# hello, markdown!',\n html = converter.makeHtml(text);\n ```\n\n === \"output\"\n\n ```html\n hello, markdown!
\n ```\n\n!!! warning \"Potential XSS vulnerabilities\"\n Showdown doesn't sanitize the input since Markdown relies on it to parse certain features correctly into HTML. As a result, this may lead to potential XSS injection vulnerabilities.\n\n Please refer to the [Markdown's XSS vulnerability](xss.md) page for more information.\n\n## Other installation methods\n\n### Tarball\n\nYou can download the latest tarball directly from [releases][releases].\n\n## Previous versions\n\nIf you're looking for Showdown prior to version 1.0.0, you can find them in the [legacy branch][legacy-branch].\n\n## Changelog\n\nThe full changelog is available [here][changelog].\n\n[legacy-branch]: https://github.com/showdownjs/showdown/tree/legacy\n[releases]: https://github.com/showdownjs/showdown/releases\n[changelog]: https://github.com/showdownjs/showdown/blob/master/CHANGELOG.md"
},
{
"path": "docs/tutorials/add-default-class-to-html.md",
"content": "# Add default class for each HTML element\n\nMany people use CSS kits like Bootstrap, Semantic UI, or others that require default name classes for HTML elements:\n\n```html\n1st Heading
\n2nd Heading
\n\n - first item
\n - second item
\n
\n```\n\nShowdown does not support this out-of-the-box. But you can create an extension for this:\n\n```js\nconst showdown = require('showdown');\n\nconst classMap = {\n h1: 'ui large header',\n h2: 'ui medium header',\n ul: 'ui list',\n li: 'ui item'\n}\n\nconst bindings = Object.keys(classMap)\n .map(key => ({\n type: 'output',\n regex: new RegExp(`<${key}(.*)>`, 'g'),\n replace: `<${key} class=\"${classMap[key]}\" $1>`\n }));\n\nconst conv = new showdown.Converter({\n extensions: [...bindings]\n});\n\nconst text = `\n# 1st Heading\n## 2nd Heading\n\n- first item\n- second item\n`;\n```\n\nWith this extension, the output will be as follows:\n\n```html\n1st Heading
\n2nd Heading
\n\n - first item
\n - second item
\n
\n```\n\n## Credits\n\n* Initial creator: [@zusamann](https://github.com/zusamann), [(original issue)](https://github.com/showdownjs/showdown/issues/376).\n* Updated by [@Kameelridder](https://github.com/Kameelridder), [(original issue)](https://github.com/showdownjs/showdown/issues/509).\n"
},
{
"path": "docs/tutorials/index.md",
"content": "# Tutorials\n\n* [Add default class for each HTML element](add-default-class-to-html.md)\n* [Markdown editor with Showdown](markdown-editor-with-showdown.md)\n* [Use language and output extensions on the same block](use-both-extension-types-together.md)"
},
{
"path": "docs/tutorials/markdown-editor-with-showdown.md",
"content": "# Markdown editor with Showdown\n\n## Introduction\n\nIn this tutorial, you will create a simple in-browser Markdown editor using Showdown and some of its extensions. The purpose is to show how easy it is to include and configure Showdown in your project.\n\nThe fully working example you can see in [Fiddle][1].\n\n## Step 1: Prepare project\n\n1. Install [node.js](https://nodejs.org/en/).\n1. Install project package management tool\n\n !!! info \"\"\n Showdown core library doesn't have any dependencies so the setup is pretty straightforward. However, you are strongly encouraged to use a package manager such as [**npm**](http://npmjs.com) or [**yarn**](https://yarnpkg.com) to manage project dependencies.\n\n To install package management tool:\n\n 1. Create a directory called `showdown-editor` and recreate the following structure:\n\n ```\n showdown-editor\n ├── css\n │ └── style.css\n ├── js\n │ └── script.js\n └── index.html\n ```\n\n 1. Initialize `package.json` file by running the following interactive console command:\n\n ```\n npm init -y\n ```\n\n This command creates `package.json` file in the root of the project folder, and populates the default content that you can change later if you wish.\n\n## Step 2: Install Showdown\n\nInside the `showdown-editor` directory, run the following command:\n\n```\nnpm install showdown --save\n```\n\nThis command will install `showdown` inside the `node_modules` directory and save `showdown` as a dependency in the `package.json` file.\n\n## Step 3: Update project files\n\nAdd the following content to the corresponding project files:\n\n=== \"index.html\"\n\n ```html\n \n \n \n \n \n \n \n \n \n
\n \n
\n \n \n \n \n \n \n ```\n\n !!! warning \"\"\n Please note how Showdown and the script file are included to the `index.html` via the `script` tag at the bottom of the file.\n\n=== \"style.css\"\n\n ```css\n #sourceTA {\n display: block;\n }\n #targetDiv {\n border: 1px dashed #333333;\n width: 600px;\n height: 400px;\n }\n ```\n\n=== \"script.js\"\n\n ```js\n function run() {\n var text = document.getElementById('sourceTA').value,\n target = document.getElementById('targetDiv'),\n converter = new showdown.Converter(),\n html = converter.makeHtml(text);\n \n target.innerHTML = html;\n }\n ```\n\n The `script.js` file is simple: when the `runBtn` button is clicked, the script gets the text of the textarea, passes it through Showdown to convert the markdown text into HTML. The resulting HTML is then put inside the `targetDiv`, replacing the previous content.\n\n## Step 4: Check the result\n\n1. Open your `index.html` file. You should see your editor with prefilled markdown text in the text area.\n1. Click `Convert` button. You show see the text to be converted to HTML:\n\n \n\nThe fully working example you can see in [Fiddle][1].\n\n## Conclusion\n\nCongratulations! :tada: You have successfully created a simple Markdown editor!\n\n[1]: http://jsfiddle.net/tivie/6bnpptkb/"
},
{
"path": "docs/tutorials/use-both-extension-types-together.md",
"content": "# Use language and output extensions on the same block\n\n## Overview\n\nShowdown allows you to define and use any number of extensions that act on the same block. These extensions can be executed sequentially or at different moments.\n\nThis enables you to pre-parse/mark a block of text but defer any modifications for the last by using a combination of language and output extensions.\n\nThis is useful if you, for example, don't want Showdown to parse the contents of your new language construct.\n\n## Example\n\nLet's say you create an extension that captures everything between `%start%` and `%end%`. However, that content should not be modified by Showdown. Obviously, you can use `` tags but that is beside the point.\n\nAlthough Showdown doesn't have any flag to prevent parsing the content of an extension, the same effect can be easily achieved by using lang and output extensions together.\n\n!!! example \"\"\n The fully working example you can see in [Fiddle][1].\n\n### Code\n\n[Create your extensions](../create-extension.md) with the following content:\n\n```js\nshowdown.extension('myExt', function() {\n var matches = [];\n return [\n { \n type: 'lang',\n regex: /%start%([^]+?)%end%/gi,\n replace: function(s, match) { \n matches.push(match);\n var n = matches.length - 1;\n return '%PLACEHOLDER' + n + '%';\n }\n },\n {\n type: 'output',\n filter: function (text) {\n for (var i=0; i< matches.length; ++i) {\n var pat = '%PLACEHOLDER' + i + '% *<\\/p>';\n text = text.replace(new RegExp(pat, 'gi'), matches[i]);\n }\n //reset array\n matches = [];\n return text;\n }\n }\n ]\n});\n```\n\nIn this example, you created a [`lang` extension](../create-extension.md#type) that:\n\n1. Checks for the pseudo tags `%start%` and `%end%`.\n1. Extracts everything in between the tags.\n1. Saves the content between the tags in a variable.\n1. Replaces the saved content with a placeholder to identify the exact position of the extracted text.\n\nand an [`output` extension](../create-extension.md#type) that replaces the placeholder with the saved content, once Showdown is finished parsing.\n\n[1]: http://jsfiddle.net/tivie/1rqr7xy8/"
},
{
"path": "docs/xss.md",
"content": "# Markdown's XSS vulnerability\n\n## Introduction\n\nCross-Site Scripting (XSS) is a well-known technique to gain access to the private information of users on a website. The attacker injects spurious HTML content (a script) on the web page. This script can read the user’s cookies and do other malicious actions (like steal credentials). As a countermeasure, you should always filter user input for suspicious content. Showdown doesn’t include an XSS filter, so you must provide your own. But be careful in how you do it.\n\n## Markdown is inherently unsafe\n\nMarkdown syntax allows the inclusion of arbitrary HTML. For example, below is a perfectly valid Markdown:\n\n```md\nThis is a regular paragraph.\n\n
\n Foo
\n\nThis is another regular paragraph.\n```\n\nThis means that an attacker could do something like this:\n\n```md\nThis is a regular paragraph.\n\n\n\nThis is another regular paragraph.\n```\n\nWhile `alert('xss');` is hardly problematic (maybe just annoying) a real-world scenario might be a lot worse. Obviously, you can easily prevent this kind of this straightforward attack. For example, you can define a whitelist for Showdown that will contain a limited set of allowed HTML tags. However, an attacker can easily circumvent this \"defense\".\n\n## Whitelist / blacklist can't prevent XSS\n\nConsider the following Markdown content:\n\n```md\nhello *you*\n```\n\nAs you can see, it's a link, nothing malicious about this. And `` tags are pretty innocuous, right? Showdown should definitely allow them. But what if the content is slightly altered, like this:\n\n```md\nhello *you*\n```\n\nNow this is a lot more problematic. Once again, it's not that hard to filter Showdown's input to expunge problematic attributes (such as `href` in `` tags) of scripting attacks. In fact, a regular HTML XSS prevention library should catch this kind of straightforward attack.\n\nAt this point you're probably thinking that the best way is to follow Stackoverflow's cue and disallow embedded HTML in Markdown. Unfortunately it's still not enough.\n\n## Strip HTML tags is not enough\n\nConsider the following Markdown input:\n\n```md\n[some text](javascript:alert('xss'))\n```\n\nShowdown will correctly parse this piece of Markdown input as:\n\n```html\nsome text\n```\n\nIn this case, it was Markdown's syntax itself to create the dangerous link. HTML XSS filter cannot catch this. And unless you start striping dangerous words like *javascript* (which would make this article extremely hard to write), there's nothing you can really do to filter XSS attacks from your input. Things get even harder when you tightly mix HTML with Markdown.\n\n## Mixed HTML/Markdown XSS attack\n\nConsider the following piece of Markdown:\n\n```md\n> hello href=\"javascript:alert('xss')\">*you*\n```\n\nIf you apply an XSS filter to filter bad HTML in this Markdown input, the XSS filter, expecting HTML, will likely think the `` tag ends with the first character on the second line and will leave the text snippet untouched. It will probably fail to see that the `href=\"javascript:…\"` is part of the `` element and leave it alone. But when Markdown converts this to HTML, you get this:\n\n```html\n\n hello you
\n
\n```\n\nAfter parsing with Markdown, the first `>` on the second line disappears because it was the blockquote marker in the Markdown blockquote syntax. As a result, you’ve got a link containing an XSS attack!\n\nDid Markdown generate the HTML? No, the HTML was already in plain sight in the input. The XSS filter couldn’t catch it because the input doesn’t follow HTML rules: it’s a mix of Markdown and HTML, and the filter doesn’t know a dime about Markdown.\n\n## Mitigate XSS\n\nSo, is it all lost? Not really. The answer is not to filter the *input* but rather the *output*. After the *input* text is converted into full-fledged HTML, you can reliably apply the correct XSS filters to remove any dangerous or malicious content.\n\nAlso, client-side validations are not reliable. It should be a given, but in case you're wondering, you should (almost) never trust data sent by the client. If there's some critical operation you must perform on the data (such as XSS filtering), you should do it *SERVER-SIDE* not client-side.\n\nHTML XSS filtering libraries are useful here since they prevent most of the attacks. However, you should not use them blindly: a library can't predict all the contexts and situations your application may face.\n\n## Conclusion\n\nShowdown tries to convert the input text as closely as possible, without any concerns for XSS attacks or malicious intent. So, the basic rules are:\n\n* **removing HTML entities from Markdown does not prevent XSS**. Markdown syntax can generate XSS attacks.\n* **XSS filtering should be done after Showdown has processed input, not before or during**. If you filter before, it will break some of Markdown’s features and will leave security holes.\n* **perform the necessary filtering server-side, not client-side**. XSS filtering libraries are useful but should not be used blindly.\n\n## Disclaimer\n\nThis page is based on the excellent article: [\"Markdown and XSS\"][1] by [Michel Fortin][2] \n\n[1]: https://michelf.ca/blog/2010/markdown-and-xss/\n[2]: https://github.com/michelf\n"
},
{
"path": "karma.browserstack.js",
"content": "module.exports = function (config) {\n config.set({\n // global config of your BrowserStack account\n browserStack: {\n username: process.env.BROWSERSTACK_USERNAME,\n accessKey: process.env.BROWSERSTACK_ACCESSKEY,\n project: process.env.BROWSERSTACK_PROJECT_NAME || 'showdown',\n build: process.env.BROWSERSTACK_BUILD_NAME || require('./package.json').version,\n name: process.env.COMMIT_MSG || 'Unit Testing'\n },\n\n // define browsers\n customLaunchers: {\n bstack_chrome_windows: {\n base: 'BrowserStack',\n browser: 'chrome',\n browser_version: '49',\n os: 'Windows',\n os_version: '10'\n },\n bstack_firefox_windows: {\n base: 'BrowserStack',\n browser: 'firefox',\n browser_version: '44',\n os: 'Windows',\n os_version: '10'\n },\n bstack_edge_windows: {\n base: 'BrowserStack',\n browser: 'edge',\n browser_version: '15',\n os: 'Windows',\n os_version: '10'\n },\n bstack_ie11_windows: {\n base: 'BrowserStack',\n browser: 'ie',\n browser_version: '11',\n os: 'Windows',\n os_version: '10'\n },\n bstack_macos_safari: {\n base: 'BrowserStack',\n browser: 'safari',\n browser_version: '10.1',\n os: 'OS X',\n os_version: 'Sierra'\n },\n bstack_iphoneX: {\n base: 'BrowserStack',\n browser: 'safari',\n os: 'ios',\n os_version: '11.0',\n device: 'iPhone X',\n real_mobile: true\n },\n bstack_android: {\n base: 'BrowserStack',\n browser: 'chrome',\n os: 'android',\n os_version:'4.4',\n device: 'Samsung Galaxy Tab 4',\n realMobile: true\n }\n },\n\n browsers: ['bstack_chrome_windows', 'bstack_firefox_windows', 'bstack_ie11_windows', 'bstack_edge_windows', 'bstack_iphoneX', 'bstack_macos_safari', 'bstack_android'],\n frameworks: ['mocha', 'chai'],\n reporters: ['dots', 'BrowserStack'],\n files: [\n { pattern: '.build/showdown.js'},\n { pattern: 'src/options.js'},\n // tests\n { pattern: 'test/unit/showdown*.js' }\n //{ pattern: 'test/functional/showdown*.js' },\n ],\n singleRun: true,\n concurrency: Infinity\n });\n};\n"
},
{
"path": "karma.conf.js",
"content": "module.exports = function (config) {\n config.set({\n client: {\n captureConsole: true\n },\n browserConsoleLogOptions: {\n level: 'log',\n format: '%b %T: %m',\n terminal: true\n },\n logLevel: config.LOG_LOG,\n frameworks: ['mocha', 'chai'],\n files: [\n { pattern: '.build/showdown.js'},\n { pattern: 'src/options.js'},\n // tests\n { pattern: 'test/unit/showdown*.js' },\n { pattern: 'test/functional/showdown*.js' },\n ],\n reporters: ['progress'],\n port: 9876, // karma web server port\n colors: true,\n browsers: ['ChromeHeadless', 'FirefoxHeadless', 'jsdom'],\n autoWatch: false,\n singleRun: true, // Karma captures browsers, runs the tests and exits\n //concurrency: Infinity,\n customLaunchers: {\n 'FirefoxHeadless': {\n base: 'Firefox',\n flags: [\n '-headless',\n ]\n }\n },\n });\n};\n"
},
{
"path": "mkdocs.yml",
"content": "site_name: Showdown documentation\nsite_description: Showdown is a JavaScript Markdown to HTML converter\n\ntheme:\n name: material\n logo: http://showdownjs.com/apple-touch-icon.png\n favicon: http://showdownjs.com/apple-touch-icon.png\n icon:\n repo: fontawesome/brands/github\n features:\n - navigation.tabs\n\nmarkdown_extensions:\n - admonition\n - pymdownx.superfences\n - pymdownx.tabbed:\n alternate_style: true \n - pymdownx.tasklist\n - pymdownx.emoji:\n emoji_index: !!python/name:materialx.emoji.twemoji\n emoji_generator: !!python/name:materialx.emoji.to_svg\n\nextra_css:\n - assets/extra.css \n \nrepo_url: https://github.com/showdownjs/showdown\nrepo_name: showdownjs/showdown\nsite_dir: public\n\nnav:\n - Home:\n - Introduction: index.md\n - Donations: donations.md\n - Credits: credits.md\n - Quickstart:\n - Quickstart: quickstart.md\n - Showdown's Markdown syntax: markdown-syntax.md\n - Compatibility: compatibility.md\n - Configuration:\n - Showdown options: configuration.md\n - Available options: available-options.md\n - Flavors: flavors.md\n - CLI: cli.md\n - Integrations: integrations.md\n - Extensions:\n - Overview: extensions.md\n - Create an extension: create-extension.md\n - List of known extensions: extensions-list.md \n - Tutorials: tutorials/index.md"
},
{
"path": "package.json",
"content": "{\n \"name\": \"showdown\",\n \"version\": \"3.0.0-alpha\",\n \"description\": \"A Markdown to HTML converter written in Javascript\",\n \"author\": \"Estevão Santos\",\n \"homepage\": \"http://showdownjs.com/\",\n \"keywords\": [\n \"markdown\",\n \"converter\"\n ],\n \"contributors\": [\n \"John Gruber\",\n \"John Fraser\",\n \"Corey Innis\",\n \"Remy Sharp\",\n \"Konstantin Käfer\",\n \"Roger Braun\",\n \"Dominic Tarr\",\n \"Cat Chen\",\n \"Titus Stone\",\n \"Rob Sutherland\",\n \"Pavel Lang\",\n \"Ben Combee\",\n \"Adam Backstrom\",\n \"Pascal Deschênes\",\n \"Estevão Santos\"\n ],\n \"funding\": {\n \"type\": \"individual\",\n \"url\": \"https://www.paypal.me/tiviesantos\"\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/showdownjs/showdown.git\",\n \"web\": \"https://github.com/showdownjs/showdown\"\n },\n \"license\": \"MIT\",\n \"main\": \"./dist/showdown.js\",\n \"scripts\": {\n \"test\": \"grunt test\"\n },\n \"bin\": {\n \"showdown\": \"bin/showdown.js\"\n },\n \"files\": [\n \"bin\",\n \"dist\"\n ],\n \"devDependencies\": {\n \"chai\": \"*\",\n \"chai-match\": \"*\",\n \"grunt\": \"^1.4.1\",\n \"grunt-contrib-clean\": \"^2.0.0\",\n \"grunt-contrib-concat\": \"^2.0.0\",\n \"grunt-contrib-jshint\": \"^3.1.0\",\n \"grunt-contrib-uglify\": \"^5.0.1\",\n \"grunt-conventional-changelog\": \"^6.1.0\",\n \"grunt-conventional-github-releaser\": \"^1.0.0\",\n \"grunt-endline\": \"^0.7.0\",\n \"grunt-eslint\": \"^24.0.0\",\n \"grunt-mocha-test\": \"^0.13.3\",\n \"grunt-simple-mocha\": \"^0.4.0\",\n \"karma\": \"^6.3.17\",\n \"karma-browserstack-launcher\": \"^1.6.0\",\n \"karma-chai\": \"^0.1.0\",\n \"karma-chrome-launcher\": \"^3.1.1\",\n \"karma-firefox-launcher\": \"^2.1.2\",\n \"karma-jsdom-launcher\": \"^12.0.0\",\n \"karma-mocha\": \"^2.0.1\",\n \"load-grunt-tasks\": \"^5.1.0\",\n \"performance-now\": \"^2.1.0\",\n \"quiet-grunt\": \"^0.2.0\",\n \"semver-sort\": \"^1.0.0\",\n \"sinon\": \"*\",\n \"source-map-support\": \"^0.5.21\"\n },\n \"dependencies\": {\n \"commander\": \"^9.0.0\",\n \"jsdom\": \"^19.0.0\"\n },\n \"overrides\": {\n \"minimist\": \"^1.2.6\"\n }\n}\n"
},
{
"path": "performance.json",
"content": "{\"2.0.0\":[{\"suiteName\":\"Basic\",\"cycles\":50,\"tests\":[{\"name\":\"Simple \\\"Hello World\\\"\",\"time\":0.5814020752906799,\"maxTime\":12.278934955596924,\"minTime\":0.15148591995239258},{\"name\":\"performance.testfile.md\",\"time\":35.49076347827911,\"maxTime\":79.40457594394684,\"minTime\":29.04559099674225}]},{\"suiteName\":\"subParsers\",\"cycles\":20,\"tests\":[{\"name\":\"hashHTMLBlocks\",\"time\":4.561372250318527,\"maxTime\":7.806509017944336,\"minTime\":2.461485981941223},{\"name\":\"anchors\",\"time\":2.9101044595241548,\"maxTime\":6.510464072227478,\"minTime\":1.055580973625183},{\"name\":\"blockQuotes\",\"time\":4.141605257987976,\"maxTime\":19.022807955741882,\"minTime\":2.540547013282776},{\"name\":\"codeBlocks\",\"time\":0.263570636510849,\"maxTime\":0.8583500385284424,\"minTime\":0.19387996196746826},{\"name\":\"codeSpans\",\"time\":0.3651615560054779,\"maxTime\":1.4206420183181763,\"minTime\":0.27775895595550537},{\"name\":\"detab\",\"time\":0.054944151639938356,\"maxTime\":0.11614596843719482,\"minTime\":0.04707300662994385},{\"name\":\"encodeAmpsAndAngles\",\"time\":0.144669109582901,\"maxTime\":0.796051025390625,\"minTime\":0.09184098243713379},{\"name\":\"encodeBackslashEscapes\",\"time\":0.08684400320053101,\"maxTime\":0.2664440870285034,\"minTime\":0.0629270076751709},{\"name\":\"encodeCode\",\"time\":0.6048604607582092,\"maxTime\":1.1443489789962769,\"minTime\":0.5217140913009644},{\"name\":\"escapeSpecialCharsWithinTagAttributes\",\"time\":0.2064647912979126,\"maxTime\":0.2871870994567871,\"minTime\":0.1843109130859375},{\"name\":\"githubCodeBlocks\",\"time\":0.25113869905471803,\"maxTime\":1.0032700300216675,\"minTime\":0.19171404838562012},{\"name\":\"hashBlock\",\"time\":0.038335990905761716,\"maxTime\":0.10441303253173828,\"minTime\":0.034361958503723145},{\"name\":\"hashElement\",\"time\":0.0046201348304748535,\"maxTime\":0.05286991596221924,\"minTime\":0.0013968944549560547},{\"name\":\"hashHTMLSpans\",\"time\":5.228999066352844,\"maxTime\":9.835397958755493,\"minTime\":4.239645004272461},{\"name\":\"hashPreCodeTags\",\"time\":0.15527103543281556,\"maxTime\":0.7053269147872925,\"minTime\":0.11698400974273682},{\"name\":\"headers\",\"time\":2.277534711360931,\"maxTime\":4.824635028839111,\"minTime\":1.6311440467834473},{\"name\":\"horizontalRule\",\"time\":0.1592068076133728,\"maxTime\":0.27559399604797363,\"minTime\":0.14848291873931885},{\"name\":\"images\",\"time\":0.15910540223121644,\"maxTime\":0.3903430700302124,\"minTime\":0.1241079568862915},{\"name\":\"italicsAndBold\",\"time\":0.2797422528266907,\"maxTime\":0.7730040550231934,\"minTime\":0.21085107326507568},{\"name\":\"lists\",\"time\":4.25269467830658,\"maxTime\":8.173315048217773,\"minTime\":3.1456509828567505},{\"name\":\"outdent\",\"time\":0.18059219121932985,\"maxTime\":0.23801898956298828,\"minTime\":0.16182196140289307},{\"name\":\"paragraphs\",\"time\":8.96755729317665,\"maxTime\":11.331398010253906,\"minTime\":7.8572129011154175},{\"name\":\"spanGamut\",\"time\":2.985103452205658,\"maxTime\":4.162191033363342,\"minTime\":2.48593008518219},{\"name\":\"strikethrough\",\"time\":0.006921297311782837,\"maxTime\":0.09889602661132812,\"minTime\":0.001326918601989746},{\"name\":\"stripLinkDefinitions\",\"time\":1.9106478571891785,\"maxTime\":2.8545520305633545,\"minTime\":1.446552038192749},{\"name\":\"tables\",\"time\":0.008185452222824097,\"maxTime\":0.12662196159362793,\"minTime\":0.0015370845794677734},{\"name\":\"unescapeSpecialChars\",\"time\":0.013451296091079711,\"maxTime\":0.07347309589385986,\"minTime\":0.009706974029541016}]}]}"
},
{
"path": "performance.log.md",
"content": "# Performance Tests for showdown\n\n\n## [version 2.0.0](https://github.com/showdownjs/showdown/tree/2.0.0)\n\n### Test Suite: Basic (50 cycles)\n| test | avgTime | max | min |\n|:-----|--------:|----:|----:|\n|Simple \"Hello World\"|0.581|12.279|0.151|\n|performance.testfile.md|35.491|79.405|29.046|\n\n### Test Suite: subParsers (20 cycles)\n| test | avgTime | max | min |\n|:-----|--------:|----:|----:|\n|hashHTMLBlocks|4.561|7.807|2.461|\n|anchors|2.910|6.510|1.056|\n|blockQuotes|4.142|19.023|2.541|\n|codeBlocks|0.264|0.858|0.194|\n|codeSpans|0.365|1.421|0.278|\n|detab|0.055|0.116|0.047|\n|encodeAmpsAndAngles|0.145|0.796|0.092|\n|encodeBackslashEscapes|0.087|0.266|0.063|\n|encodeCode|0.605|1.144|0.522|\n|escapeSpecialCharsWithinTagAttributes|0.206|0.287|0.184|\n|githubCodeBlocks|0.251|1.003|0.192|\n|hashBlock|0.038|0.104|0.034|\n|hashElement|0.005|0.053|0.001|\n|hashHTMLSpans|5.229|9.835|4.240|\n|hashPreCodeTags|0.155|0.705|0.117|\n|headers|2.278|4.825|1.631|\n|horizontalRule|0.159|0.276|0.148|\n|images|0.159|0.390|0.124|\n|italicsAndBold|0.280|0.773|0.211|\n|lists|4.253|8.173|3.146|\n|outdent|0.181|0.238|0.162|\n|paragraphs|8.968|11.331|7.857|\n|spanGamut|2.985|4.162|2.486|\n|strikethrough|0.007|0.099|0.001|\n|stripLinkDefinitions|1.911|2.855|1.447|\n|tables|0.008|0.127|0.002|\n|unescapeSpecialChars|0.013|0.073|0.010|\n\n\n"
},
{
"path": "src/cli/cli.js",
"content": "/**\n * Created by tivie\n */\nvar fs = require('fs'),\n path = require('path'),\n Command = require('commander').Command,\n program = new Command(),\n path1 = path.resolve(__dirname + '/../dist/showdown.js'),\n path2 = path.resolve(__dirname + '/../../.build/showdown.js'),\n showdown,\n version;\n\n// require shodown. We use conditional loading for each use case\nif (fs.existsSync(path1)) {\n // production. File lives in bin directory\n showdown = require(path1);\n version = require(path.resolve(__dirname + '/../package.json')).version;\n} else if (fs.existsSync(path2)) {\n // testing envo, uses the concatenated stuff for testing\n showdown = require(path2);\n version = require(path.resolve(__dirname + '/../../package.json')).version;\n} else {\n // cold testing (manual) of cli.js in the src file. We load the dist file\n showdown = require('../../dist/showdown');\n version = require('../../package.json');\n}\n\n\nprogram\n .name('showdown')\n .description('CLI to Showdownjs markdown parser v' + version)\n .version(version)\n .usage(' [options]')\n .option('-q, --quiet', 'Quiet mode. Only print errors')\n .option('-m, --mute', 'Mute mode. Does not print anything');\n\nprogram.command('makehtml')\n .description('Converts markdown into html')\n\n .addHelpText('after', '\\n\\nExamples:')\n .addHelpText('after', ' showdown makehtml -i Reads from stdin and outputs to stdout')\n .addHelpText('after', ' showdown makehtml -i foo.md -o bar.html Reads \\'foo.md\\' and writes to \\'bar.html\\'')\n .addHelpText('after', ' showdown makehtml -i --flavor=\"github\" Parses stdin using GFM style')\n\n .addHelpText('after', '\\nNote for windows users:')\n .addHelpText('after', 'When reading from stdin, use option -u to set the proper encoding or run `chcp 65001` prior to calling showdown cli to set the command line to utf-8')\n\n .option('-i, --input [file]', 'Input source. Usually a md file. If omitted or empty, reads from stdin. Windows users see note below.', true)\n .option('-o, --output [file]', 'Output target. Usually a html file. If omitted or empty, writes to stdout', true)\n .option('-u, --encoding ', 'Sets the input encoding', 'utf8')\n .option('-y, --output-encoding ', 'Sets the output encoding', 'utf8')\n .option('-a, --append', 'Append data to output instead of overwriting. Ignored if writing to stdout', false)\n .option('-e, --extensions ', 'Load the specified extensions. Should be valid paths to node compatible extensions')\n .option('-p, --flavor ', 'Run with a predetermined flavor of options. Default is vanilla', 'vanilla')\n .option('-c, --config ', 'Enables showdown makehtml parser config options. Overrides flavor')\n .option('--config-help', 'Shows configuration options for showdown parser')\n .action(makehtmlCommand);\n\nprogram.parse();\n\n\n//\n// HELPER FUCNTIONS\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////\n\n/**\n * Messenger helper object to the CLI\n * @param {string} writeMode\n * @param {boolean} supress\n * @param {boolean} mute\n * @constructor\n */\nfunction Messenger (writeMode, supress, mute) {\n 'use strict';\n writeMode = writeMode || 'stderr';\n supress = (!!supress || !!mute);\n mute = !!mute;\n this._print = (writeMode === 'stdout') ? console.log : console.error;\n\n this.errorExit = function (e) {\n if (!mute) {\n console.error('ERROR: ' + e.message);\n console.error('Run \\'showdown -h\\' for help');\n }\n process.exit(1);\n };\n\n this.okExit = function () {\n if (!mute) {\n this._print('\\n');\n this._print('DONE!');\n }\n process.exit(0);\n };\n\n this.printMsg = function (msg) {\n if (supress || mute || !msg) {\n return;\n }\n this._print(msg);\n };\n\n this.printError = function (msg) {\n if (mute) {\n return;\n }\n console.error(msg);\n };\n\n}\n\n/**\n * Helper function to show Showdown Options\n */\nfunction showShowdownOptions () {\n 'use strict';\n var showdownOptions = showdown.getDefaultOptions(false);\n console.log('\\nshowdown makehtml config options:');\n // show showdown options\n for (var sopt in showdownOptions) {\n if (showdownOptions.hasOwnProperty(sopt)) {\n console.log(' ' + sopt + ':', '[default=' + showdownOptions[sopt].defaultValue + ']',showdownOptions[sopt].describe);\n }\n }\n console.log('\\n\\nExample: showdown makehtml -c openLinksInNewWindow ghMentions ghMentionsLink=\"https://google.com\"');\n}\n\n/**\n * Helper function to parse showdown options\n * @param {{}} configOptions\n * @param {{}} defaultOptions\n * @returns {{}}\n */\nfunction parseShowdownOptions (configOptions, defaultOptions) {\n 'use strict';\n var shOpt = defaultOptions;\n\n // first prepare passed options\n if (configOptions) {\n for (var i = 0; i < configOptions.length; ++i) {\n var opt = configOptions[i],\n key = configOptions[i],\n val = true;\n if (/=/.test(opt)) {\n key = opt.split('=')[0];\n val = opt.split('=')[1];\n }\n shOpt[key] = val;\n }\n }\n return shOpt;\n}\n\n/**\n * Reads stdin\n * @returns {string}\n */\nfunction readFromStdIn (encoding) {\n 'use strict';\n /*\n // aparently checking the size of stdin is unreliable so we just won't test\n var size = fs.fstatSync(process.stdin.fd).size;\n if (size <= 0) {\n throw new Error('Could not read from stdin, reason: stdin is empty');\n }\n */\n encoding = encoding || 'utf8';\n try {\n return fs.readFileSync(process.stdin.fd, encoding).toString();\n } catch (e) {\n throw new Error('Could not read from stdin, reason: ' + e.message);\n }\n}\n\n/**\n * Reads from a file\n * @param {string} file Filepath to dile\n * @param {string} encoding Encoding of the file\n * @returns {Buffer}\n */\nfunction readFromFile (file, encoding) {\n 'use strict';\n try {\n return fs.readFileSync(file, encoding);\n } catch (err) {\n throw new Error('Could not read from file ' + file + ', reason: ' + err.message);\n }\n}\n\n/**\n * Writes to stdout\n * @param {string} html\n * @returns {boolean}\n */\nfunction writeToStdOut (html) {\n 'use strict';\n if (!process.stdout.write(html)) {\n throw new Error('Could not write to StdOut');\n }\n}\n\n/**\n * Writes to file\n * @param {string} html HTML to write\n * @param {string} file Filepath\n * @param {boolean} append If the result should be appended\n */\nfunction writeToFile (html, file, append) {\n 'use strict';\n // If a flag is passed, it means we should append instead of overwriting.\n // Only works with files, obviously\n var write = (append) ? fs.appendFileSync : fs.writeFileSync;\n try {\n write(file, html);\n } catch (err) {\n throw new Error('Could not write to file ' + file + ', readon: ' + err.message);\n }\n}\n\n/**\n * makehtml command\n * @param {{}} options\n * @param {Command} cmd\n */\nfunction makehtmlCommand (options, cmd) {\n 'use strict';\n\n // show configuration options for showdown helper if configHelp was passed\n if (options.configHelp) {\n showShowdownOptions();\n return;\n }\n\n var quiet = !!(cmd.parent._optionValues.quiet),\n mute = !!(cmd.parent._optionValues.mute),\n readMode = (!options.input || options.input === '' || options.input === true) ? 'stdin' : 'file',\n writeMode = (!options.output || options.output === '' || options.output === true) ? 'stdout' : 'file',\n msgMode = (writeMode === 'file') ? 'stdout' : 'stderr',\n // initiate Messenger helper, can maybe be replaced with commanderjs internal stuff\n messenger = new Messenger(msgMode, quiet, mute),\n defaultOptions = showdown.getDefaultOptions(true),\n md, html;\n\n // deal with flavor first since config flag overrides flavor individual options\n if (options.flavor) {\n messenger.printMsg('Enabling flavor ' + options.flavor + '...');\n defaultOptions = showdown.getFlavorOptions(options.flavor);\n if (!defaultOptions) {\n messenger.errorExit(new Error('Flavor ' + options.flavor + ' is not recognised'));\n return;\n }\n messenger.printMsg('OK!');\n }\n // store config options in the options.config as an object\n options.config = parseShowdownOptions(options.config, defaultOptions);\n\n // print enabled options\n for (var o in options.config) {\n if (options.config.hasOwnProperty(o) && options.config[o] === true) {\n messenger.printMsg('Enabling option ' + o);\n }\n }\n\n // initialize the converter\n messenger.printMsg('\\nInitializing converter...');\n var converter;\n try {\n converter = new showdown.Converter(options.config);\n } catch (e) {\n messenger.errorExit(e);\n return;\n }\n messenger.printMsg('OK!');\n\n // load extensions\n if (options.extensions) {\n messenger.printMsg('\\nLoading extensions...');\n for (var i = 0; i < options.extensions.length; ++i) {\n try {\n messenger.printMsg(options.extensions[i]);\n var ext = require(options.extensions[i]);\n converter.addExtension(ext, options.extensions[i]);\n messenger.printMsg(options.extensions[i] + ' loaded...');\n } catch (e) {\n messenger.printError('ERROR: Could not load extension ' + options.extensions[i] + '. Reason:');\n messenger.errorExit(e);\n }\n }\n }\n\n messenger.printMsg('...');\n // read the input\n messenger.printMsg('Reading data from ' + readMode + '...');\n\n if (readMode === 'stdin') {\n try {\n md = readFromStdIn(options.encoding);\n } catch (err) {\n messenger.errorExit(err);\n return;\n }\n } else {\n try {\n md = readFromFile(options.input, options.encoding);\n } catch (err) {\n messenger.errorExit(err);\n return;\n }\n }\n\n // process the input\n messenger.printMsg('Parsing markdown...');\n html = converter.makeHtml(md);\n\n // write the output\n messenger.printMsg('Writing data to ' + writeMode + '...');\n if (writeMode === 'stdout') {\n try {\n writeToStdOut(html);\n } catch (err) {\n messenger.errorExit(err);\n return;\n }\n } else {\n try {\n writeToFile(html, options.output, options.append);\n } catch (err) {\n messenger.errorExit(err);\n return;\n }\n }\n messenger.okExit();\n}\n"
},
{
"path": "src/converter.js",
"content": "/**\n * Created by Estevao on 31-05-2015.\n */\n\n/**\n * Showdown Converter class\n * @class\n * @param {object} [converterOptions]\n * @returns {Converter}\n */\nshowdown.Converter = function (converterOptions) {\n 'use strict';\n\n var\n /**\n * Options used by this converter\n * @private\n * @type {{}}\n */\n options = {},\n\n /**\n * Language extensions used by this converter\n * @private\n * @type {Array}\n */\n langExtensions = [],\n\n /**\n * Output modifiers extensions used by this converter\n * @private\n * @type {Array}\n */\n outputModifiers = [],\n\n /**\n * Event listeners\n * @private\n * @type {{}}\n */\n listeners = {},\n\n /**\n * The flavor set in this converter\n */\n setConvFlavor = setFlavor,\n\n /**\n * Metadata of the document\n * @type {{parsed: {}, raw: string, format: string}}\n */\n metadata = {\n parsed: {},\n raw: '',\n format: ''\n };\n\n _constructor();\n\n /**\n * Converter constructor\n * @private\n */\n function _constructor () {\n converterOptions = converterOptions || {};\n\n for (var gOpt in globalOptions) {\n if (globalOptions.hasOwnProperty(gOpt)) {\n options[gOpt] = globalOptions[gOpt];\n }\n }\n\n // Merge options\n if (typeof converterOptions === 'object') {\n for (var opt in converterOptions) {\n if (converterOptions.hasOwnProperty(opt)) {\n options[opt] = converterOptions[opt];\n }\n }\n } else {\n throw Error('Converter expects the passed parameter to be an object, but ' + typeof converterOptions +\n ' was passed instead.');\n }\n\n if (options.extensions) {\n showdown.helper.forEach(options.extensions, _parseExtension);\n }\n }\n\n /**\n * Parse extension\n * @param {*} ext\n * @param {string} [name='']\n * @private\n */\n function _parseExtension (ext, name) {\n\n name = name || null;\n // If it's a string, the extension was previously loaded\n if (showdown.helper.isString(ext)) {\n ext = showdown.helper.stdExtName(ext);\n name = ext;\n\n // LEGACY_SUPPORT CODE\n if (showdown.extensions[ext]) {\n console.warn('DEPRECATION WARNING: ' + ext + ' is an old extension that uses a deprecated loading method.' +\n 'Please inform the developer that the extension should be updated!');\n legacyExtensionLoading(showdown.extensions[ext], ext);\n return;\n // END LEGACY SUPPORT CODE\n\n } else if (!showdown.helper.isUndefined(extensions[ext])) {\n ext = extensions[ext];\n\n } else {\n throw Error('Extension \"' + ext + '\" could not be loaded. It was either not found or is not a valid extension.');\n }\n }\n\n if (typeof ext === 'function') {\n ext = ext();\n }\n\n if (!showdown.helper.isArray(ext)) {\n ext = [ext];\n }\n\n var validExt = validate(ext, name);\n if (!validExt.valid) {\n throw Error(validExt.error);\n }\n\n for (var i = 0; i < ext.length; ++i) {\n switch (ext[i].type) {\n\n case 'lang':\n langExtensions.push(ext[i]);\n break;\n\n case 'output':\n outputModifiers.push(ext[i]);\n break;\n }\n if (ext[i].hasOwnProperty('listeners')) {\n for (var ln in ext[i].listeners) {\n if (ext[i].listeners.hasOwnProperty(ln)) {\n listen(ln, ext[i].listeners[ln]);\n }\n }\n }\n }\n\n }\n\n /**\n * LEGACY_SUPPORT\n * @param {*} ext\n * @param {string} name\n */\n function legacyExtensionLoading (ext, name) {\n if (typeof ext === 'function') {\n ext = ext(new showdown.Converter());\n }\n if (!showdown.helper.isArray(ext)) {\n ext = [ext];\n }\n var valid = validate(ext, name);\n\n if (!valid.valid) {\n throw Error(valid.error);\n }\n\n for (var i = 0; i < ext.length; ++i) {\n switch (ext[i].type) {\n case 'lang':\n langExtensions.push(ext[i]);\n break;\n case 'output':\n outputModifiers.push(ext[i]);\n break;\n default:// should never reach here\n throw Error('Extension loader error: Type unrecognized!!!');\n }\n }\n }\n\n /**\n * Listen to an event\n * @param {string} name\n * @param {function} callback\n */\n function listen (name, callback) {\n if (!showdown.helper.isString(name)) {\n throw Error('Invalid argument in converter.listen() method: name must be a string, but ' + typeof name + ' given');\n }\n\n if (typeof callback !== 'function') {\n throw Error('Invalid argument in converter.listen() method: callback must be a function, but ' + typeof callback + ' given');\n }\n name = name.toLowerCase();\n if (!listeners.hasOwnProperty(name)) {\n listeners[name] = [];\n }\n listeners[name].push(callback);\n }\n\n function rTrimInputText (text) {\n var rsp = text.match(/^\\s*/)[0].length,\n rgx = new RegExp('^\\\\s{0,' + rsp + '}', 'gm');\n return text.replace(rgx, '');\n }\n\n /**\n *\n * @param {string} evtName Event name\n * @param {string} text Text\n * @param {{}} options Converter Options\n * @param {{}} globals Converter globals\n * @param {{}} [pParams] extra params for event\n * @returns showdown.helper.Event\n * @private\n */\n this._dispatch = function dispatch (evtName, text, options, globals, pParams) {\n evtName = evtName.toLowerCase();\n var params = pParams || {};\n params.converter = this;\n params.text = text;\n params.options = options;\n params.globals = globals;\n var event = new showdown.helper.Event(evtName, text, params);\n\n if (listeners.hasOwnProperty(evtName)) {\n for (var ei = 0; ei < listeners[evtName].length; ++ei) {\n var nText = listeners[evtName][ei](event);\n if (nText && typeof nText !== 'undefined') {\n event.setText(nText);\n }\n }\n }\n return event;\n };\n\n /**\n * Listen to an event\n * @param {string} name\n * @param {function} callback\n * @returns {showdown.Converter}\n */\n this.listen = function (name, callback) {\n listen(name, callback);\n return this;\n };\n\n /**\n * Converts a markdown string into HTML string\n * @param {string} text\n * @returns {*}\n */\n this.makeHtml = function (text) {\n //check if text is not falsy\n if (!text) {\n return text;\n }\n\n var globals = {\n gHtmlBlocks: [],\n gHtmlMdBlocks: [],\n gHtmlSpans: [],\n gUrls: {},\n gTitles: {},\n gDimensions: {},\n gListLevel: 0,\n hashLinkCounts: {},\n langExtensions: langExtensions,\n outputModifiers: outputModifiers,\n converter: this,\n ghCodeBlocks: [],\n metadata: {\n parsed: {},\n raw: '',\n format: ''\n }\n };\n\n // This lets us use ¨ trema as an escape char to avoid md5 hashes\n // The choice of character is arbitrary; anything that isn't\n // magic in Markdown will work.\n text = text.replace(/¨/g, '¨T');\n\n // Replace $ with ¨D\n // RegExp interprets $ as a special character\n // when it's in a replacement string\n text = text.replace(/\\$/g, '¨D');\n\n // Standardize line endings\n text = text.replace(/\\r\\n/g, '\\n'); // DOS to Unix\n text = text.replace(/\\r/g, '\\n'); // Mac to Unix\n\n // Stardardize line spaces\n text = text.replace(/\\u00A0/g, ' ');\n\n if (options.smartIndentationFix) {\n text = rTrimInputText(text);\n }\n\n // Make sure text begins and ends with a couple of newlines:\n text = '\\n\\n' + text + '\\n\\n';\n\n // detab\n text = showdown.subParser('makehtml.detab')(text, options, globals);\n\n /**\n * Strip any lines consisting only of spaces and tabs.\n * This makes subsequent regexs easier to write, because we can\n * match consecutive blank lines with /\\n+/ instead of something\n * contorted like /[ \\t]*\\n+/\n */\n text = text.replace(/^[ \\t]+$/mg, '');\n\n //run languageExtensions\n showdown.helper.forEach(langExtensions, function (ext) {\n text = showdown.subParser('makehtml.runExtension')(ext, text, options, globals);\n });\n\n // run the sub parsers\n text = showdown.subParser('makehtml.metadata')(text, options, globals);\n text = showdown.subParser('makehtml.hashPreCodeTags')(text, options, globals);\n text = showdown.subParser('makehtml.githubCodeBlocks')(text, options, globals);\n text = showdown.subParser('makehtml.hashHTMLBlocks')(text, options, globals);\n text = showdown.subParser('makehtml.hashCodeTags')(text, options, globals);\n text = showdown.subParser('makehtml.stripLinkDefinitions')(text, options, globals);\n text = showdown.subParser('makehtml.blockGamut')(text, options, globals);\n text = showdown.subParser('makehtml.unhashHTMLSpans')(text, options, globals);\n text = showdown.subParser('makehtml.unescapeSpecialChars')(text, options, globals);\n\n // attacklab: Restore dollar signs\n text = text.replace(/¨D/g, '$$');\n\n // attacklab: Restore tremas\n text = text.replace(/¨T/g, '¨');\n\n // render a complete html document instead of a partial if the option is enabled\n text = showdown.subParser('makehtml.completeHTMLDocument')(text, options, globals);\n\n // Run output modifiers\n showdown.helper.forEach(outputModifiers, function (ext) {\n text = showdown.subParser('makehtml.runExtension')(ext, text, options, globals);\n });\n\n // update metadata\n metadata = globals.metadata;\n return text;\n };\n\n /**\n * Converts an HTML string into a markdown string\n * @param src\n * @returns {string}\n */\n this.makeMarkdown = function (src) {\n\n // replace \\r\\n with \\n\n src = src.replace(/\\r\\n/g, '\\n');\n src = src.replace(/\\r/g, '\\n'); // old macs\n\n // due to an edge case, we need to find this: > <\n // to prevent removing of non silent white spaces\n // ex: this is sparta\n src = src.replace(/>[ \\t]+¨NBSP;<');\n\n var doc = showdown.helper.document.createElement('div');\n doc.innerHTML = src;\n\n var globals = {\n preList: substitutePreCodeTags(doc)\n };\n\n // remove all newlines and collapse spaces\n clean(doc);\n\n // some stuff, like accidental reference links must now be escaped\n // TODO\n // doc.innerHTML = doc.innerHTML.replace(/\\[[\\S\\t ]]/);\n\n var nodes = doc.childNodes,\n mdDoc = '';\n\n for (var i = 0; i < nodes.length; i++) {\n mdDoc += showdown.subParser('makeMarkdown.node')(nodes[i], options, globals);\n }\n\n function clean (node) {\n for (var n = 0; n < node.childNodes.length; ++n) {\n var child = node.childNodes[n];\n if (child.nodeType === 3) {\n if (!/\\S/.test(child.nodeValue) && !/^[ ]+$/.test(child.nodeValue)) {\n node.removeChild(child);\n --n;\n } else {\n child.nodeValue = child.nodeValue.split('\\n').join(' ');\n child.nodeValue = child.nodeValue.replace(/(\\s)+/g, '$1');\n }\n } else if (child.nodeType === 1) {\n clean(child);\n }\n }\n }\n\n // find all pre tags and replace contents with placeholder\n // we need this so that we can remove all indentation from html\n // to ease up parsing\n function substitutePreCodeTags (doc) {\n\n var pres = doc.querySelectorAll('pre'),\n presPH = [];\n\n for (var i = 0; i < pres.length; ++i) {\n\n if (pres[i].childElementCount === 1 && pres[i].firstChild.tagName.toLowerCase() === 'code') {\n var content = pres[i].firstChild.innerHTML.trim(),\n language = pres[i].firstChild.getAttribute('data-language') || '';\n\n // if data-language attribute is not defined, then we look for class language-*\n if (language === '') {\n var classes = pres[i].firstChild.className.split(' ');\n for (var c = 0; c < classes.length; ++c) {\n var matches = classes[c].match(/^language-(.+)$/);\n if (matches !== null) {\n language = matches[1];\n break;\n }\n }\n }\n\n // unescape html entities in content\n content = showdown.helper.unescapeHTMLEntities(content);\n\n presPH.push(content);\n pres[i].outerHTML = '\n * MIT License\n *\n * Accepts a string to search, a left and right format delimiter\n * as regex patterns, and optional regex flags. Returns an array\n * of matches, allowing nested instances of left/right delimiters.\n * Use the \"g\" flag to return all matches, otherwise only the\n * first is returned. Be careful to ensure that the left and\n * right format delimiters produce mutually exclusive matches.\n * Backreferences are not supported within the right delimiter\n * due to how it is internally combined with the left delimiter.\n * When matching strings whose format delimiters are unbalanced\n * to the left or right, the output is intentionally as a\n * conventional regex library with recursion support would\n * produce, e.g. \"<\" and \">\" both produce [\"x\"] when using\n * \"<\" and \">\" as the delimiters (both strings contain a single,\n * balanced instance of \"\").\n *\n * examples:\n * matchRecursiveRegExp(\"test\", \"\\\\(\", \"\\\\)\")\n * returns: []\n * matchRecursiveRegExp(\">>t<>\", \"<\", \">\", \"g\")\n * returns: [\"t<>\", \"\"]\n * matchRecursiveRegExp(\"test\", \"]*>\", \"
',\n 'basecamp': '',\n 'basecampy': '',\n 'bowtie': '',\n 'electron': '',\n 'feelsgood': '',\n 'finnadie': '',\n 'goberserk': '',\n 'godmode': '',\n 'hurtrealbad': '',\n 'neckbeard': '',\n 'octocat': '',\n 'rage1': '',\n 'rage2': '',\n 'rage3': '',\n 'rage4': '',\n 'shipit': '',\n 'suspect': '',\n 'trollface': '',\n 'showdown': '(GFM Style)',\n type: 'boolean'\n },\n requireSpaceBeforeHeadingText: {\n defaultValue: false,\n describe: 'Makes adding a space between `#` and the header text mandatory (GFM Style)',\n type: 'boolean'\n },\n ghMentions: {\n defaultValue: false,\n describe: 'Enables github @mentions',\n type: 'boolean'\n },\n ghMentionsLink: {\n defaultValue: 'https://github.com/{u}',\n describe: 'Changes the link generated by @mentions. Only applies if ghMentions option is enabled.',\n type: 'string'\n },\n encodeEmails: {\n defaultValue: true,\n describe: 'Encode e-mail addresses through the use of Character Entities, transforming ASCII e-mail addresses into its equivalent decimal entities',\n type: 'boolean'\n },\n openLinksInNewWindow: {\n defaultValue: false,\n describe: 'Open all links in new windows',\n type: 'boolean'\n },\n backslashEscapesHTMLTags: {\n defaultValue: false,\n describe: 'Support for HTML Tag escaping. ex: \\
tags around block-level tags.\n text = showdown.subParser('makehtml.hashHTMLBlocks')(text, options, globals);\n text = showdown.subParser('makehtml.paragraphs')(text, options, globals);\n\n text = globals.converter._dispatch('makehtml.blockGamut.after', text, options, globals).getText();\n\n return text;\n});\n" }, { "path": "src/subParsers/makehtml/blockQuotes.js", "content": "showdown.subParser('makehtml.blockQuotes', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.blockQuotes.before', text, options, globals).getText();\n\n // add a couple extra lines after the text and endtext mark\n text = text + '\\n\\n';\n\n var rgx = /(^ {0,3}>[ \\t]?.+\\n(.+\\n)*\\n*)+/gm;\n\n if (options.splitAdjacentBlockquotes) {\n rgx = /^ {0,3}>[\\s\\S]*?(?:\\n\\n)/gm;\n }\n\n text = text.replace(rgx, function (bq) {\n // attacklab: hack around Konqueror 3.5.4 bug:\n // \"----------bug\".replace(/^-/g,\"\") == \"bug\"\n bq = bq.replace(/^[ \\t]*>[ \\t]?/gm, ''); // trim one level of quoting\n\n // attacklab: clean up hack\n bq = bq.replace(/¨0/g, '');\n\n bq = bq.replace(/^[ \\t]+$/gm, ''); // trim whitespace-only lines\n bq = showdown.subParser('makehtml.githubCodeBlocks')(bq, options, globals);\n bq = showdown.subParser('makehtml.blockGamut')(bq, options, globals); // recurse\n\n bq = bq.replace(/(^|\\n)/g, '$1 ');\n // These leading spaces screw with
content, so we need to fix that:\n bq = bq.replace(/(\\s*[^\\r]+?<\\/pre>)/gm, function (wholeMatch, m1) {\n var pre = m1;\n // attacklab: hack around Konqueror 3.5.4 bug:\n pre = pre.replace(/^ /mg, '¨0');\n pre = pre.replace(/¨0/g, '');\n return pre;\n });\n\n return showdown.subParser('makehtml.hashBlock')('\\n' + bq + '\\n
', options, globals);\n });\n\n text = globals.converter._dispatch('makehtml.blockQuotes.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/codeBlocks.js",
"content": "/**\n * Process Markdown `` blocks.\n */\nshowdown.subParser('makehtml.codeBlocks', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.codeBlocks.before', text, options, globals).getText();\n\n // sentinel workarounds for lack of \\A and \\Z, safari\\khtml bug\n text += '¨0';\n\n var pattern = /(?:\\n\\n|^)((?:(?:[ ]{4}|\\t).*\\n+)+)(\\n*[ ]{0,3}[^ \\t\\n]|(?=¨0))/g;\n text = text.replace(pattern, function (wholeMatch, m1, m2) {\n var codeblock = m1,\n nextChar = m2,\n end = '\\n';\n\n codeblock = showdown.subParser('makehtml.outdent')(codeblock, options, globals);\n codeblock = showdown.subParser('makehtml.encodeCode')(codeblock, options, globals);\n codeblock = showdown.subParser('makehtml.detab')(codeblock, options, globals);\n codeblock = codeblock.replace(/^\\n+/g, ''); // trim leading newlines\n codeblock = codeblock.replace(/\\n+$/g, ''); // trim trailing newlines\n\n if (options.omitExtraWLInCodeBlocks) {\n end = '';\n }\n\n codeblock = '' + codeblock + end + '
';\n\n return showdown.subParser('makehtml.hashBlock')(codeblock, options, globals) + nextChar;\n });\n\n // strip sentinel\n text = text.replace(/¨0/, '');\n\n text = globals.converter._dispatch('makehtml.codeBlocks.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/codeSpans.js",
"content": "/**\n *\n * * Backtick quotes are used for Just type foo `bar` baz at the prompt.
\n *\n * There's no arbitrary limit to the number of backticks you\n * can use as delimters. If you need three consecutive backticks\n * in your code, use four for delimiters, etc.\n *\n * * You can use spaces to get literal backticks at the edges:\n *\n * ... type `` `bar` `` ...\n *\n * Turns to:\n *\n * ... type `bar` ...\n */\nshowdown.subParser('makehtml.codeSpans', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.codeSpans.before', text, options, globals).getText();\n\n if (typeof (text) === 'undefined') {\n text = '';\n }\n text = text.replace(/(^|[^\\\\])(`+)([^\\r]*?[^`])\\2(?!`)/gm,\n function (wholeMatch, m1, m2, m3) {\n var c = m3;\n c = c.replace(/^([ \\t]*)/g, '');\t// leading whitespace\n c = c.replace(/[ \\t]*$/g, '');\t// trailing whitespace\n c = showdown.subParser('makehtml.encodeCode')(c, options, globals);\n c = m1 + '' + c + '';\n c = showdown.subParser('makehtml.hashHTMLSpans')(c, options, globals);\n return c;\n }\n );\n\n text = globals.converter._dispatch('makehtml.codeSpans.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/completeHTMLDocument.js",
"content": "/**\n * Create a full HTML document from the processed markdown\n */\nshowdown.subParser('makehtml.completeHTMLDocument', function (text, options, globals) {\n 'use strict';\n\n if (!options.completeHTMLDocument) {\n return text;\n }\n\n text = globals.converter._dispatch('makehtml.completeHTMLDocument.before', text, options, globals).getText();\n\n var doctype = 'html',\n doctypeParsed = '\\n',\n title = '',\n charset = '\\n',\n lang = '',\n metadata = '';\n\n if (typeof globals.metadata.parsed.doctype !== 'undefined') {\n doctypeParsed = '\\n';\n doctype = globals.metadata.parsed.doctype.toString().toLowerCase();\n if (doctype === 'html' || doctype === 'html5') {\n charset = '';\n }\n }\n\n for (var meta in globals.metadata.parsed) {\n if (globals.metadata.parsed.hasOwnProperty(meta)) {\n switch (meta.toLowerCase()) {\n case 'doctype':\n break;\n\n case 'title':\n title = '' + globals.metadata.parsed.title + ' \\n';\n break;\n\n case 'charset':\n if (doctype === 'html' || doctype === 'html5') {\n charset = '\\n';\n } else {\n charset = '\\n';\n }\n break;\n\n case 'language':\n case 'lang':\n lang = ' lang=\"' + globals.metadata.parsed[meta] + '\"';\n metadata += '\\n';\n break;\n\n default:\n metadata += '\\n';\n }\n }\n }\n\n text = doctypeParsed + '\\n\\n' + title + charset + metadata + '\\n\\n' + text.trim() + '\\n\\n';\n\n text = globals.converter._dispatch('makehtml.completeHTMLDocument.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/detab.js",
"content": "/**\n * Convert all tabs to spaces\n */\nshowdown.subParser('makehtml.detab', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.detab.before', text, options, globals).getText();\n\n // expand first n-1 tabs\n text = text.replace(/\\t(?=\\t)/g, ' '); // g_tab_width\n\n // replace the nth with two sentinels\n text = text.replace(/\\t/g, '¨A¨B');\n\n // use the sentinel to anchor our regex so it doesn't explode\n text = text.replace(/¨B(.+?)¨A/g, function (wholeMatch, m1) {\n var leadingText = m1,\n numSpaces = 4 - leadingText.length % 4; // g_tab_width\n\n // there *must* be a better way to do this:\n for (var i = 0; i < numSpaces; i++) {\n leadingText += ' ';\n }\n\n return leadingText;\n });\n\n // clean up sentinels\n text = text.replace(/¨A/g, ' '); // g_tab_width\n text = text.replace(/¨B/g, '');\n\n text = globals.converter._dispatch('makehtml.detab.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/ellipsis.js",
"content": "showdown.subParser('makehtml.ellipsis', function (text, options, globals) {\n 'use strict';\n\n if (!options.ellipsis) {\n return text;\n }\n\n text = globals.converter._dispatch('makehtml.ellipsis.before', text, options, globals).getText();\n\n text = text.replace(/\\.\\.\\./g, '…');\n\n text = globals.converter._dispatch('makehtml.ellipsis.after', text, options, globals).getText();\n\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/emoji.js",
"content": "/**\n * Turn emoji codes into emojis\n *\n * List of supported emojis: https://github.com/showdownjs/showdown/wiki/Emojis\n */\nshowdown.subParser('makehtml.emoji', function (text, options, globals) {\n 'use strict';\n\n if (!options.emoji) {\n return text;\n }\n\n text = globals.converter._dispatch('makehtml.emoji.before', text, options, globals).getText();\n\n var emojiRgx = /:([\\S]+?):/g;\n\n text = text.replace(emojiRgx, function (wm, emojiCode) {\n if (showdown.helper.emojis.hasOwnProperty(emojiCode)) {\n return showdown.helper.emojis[emojiCode];\n }\n return wm;\n });\n\n text = globals.converter._dispatch('makehtml.emoji.after', text, options, globals).getText();\n\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/encodeAmpsAndAngles.js",
"content": "/**\n * Smart processing for ampersands and angle brackets that need to be encoded.\n */\nshowdown.subParser('makehtml.encodeAmpsAndAngles', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.encodeAmpsAndAngles.before', text, options, globals).getText();\n\n // Ampersand-encoding based entirely on Nat Irons's Amputator MT plugin:\n // http://bumppo.net/projects/amputator/\n text = text.replace(/&(?!#?[xX]?(?:[0-9a-fA-F]+|\\w+);)/g, '&');\n\n // Encode naked <'s\n text = text.replace(/<(?![a-z\\/?$!])/gi, '<');\n\n // Encode <\n text = text.replace(/\n text = text.replace(/>/g, '>');\n\n text = globals.converter._dispatch('makehtml.encodeAmpsAndAngles.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/encodeBackslashEscapes.js",
"content": "/**\n * Returns the string, with after processing the following backslash escape sequences.\n *\n * attacklab: The polite way to do this is with the new escapeCharacters() function:\n *\n * text = escapeCharacters(text,\"\\\\\",true);\n * text = escapeCharacters(text,\"`*_{}[]()>#+-.!\",true);\n *\n * ...but we're sidestepping its use of the (slow) RegExp constructor\n * as an optimization for Firefox. This function gets called a LOT.\n */\nshowdown.subParser('makehtml.encodeBackslashEscapes', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.encodeBackslashEscapes.before', text, options, globals).getText();\n\n text = text.replace(/\\\\(\\\\)/g, showdown.helper.escapeCharactersCallback);\n text = text.replace(/\\\\([`*_{}\\[\\]()>#+.!~=|:-])/g, showdown.helper.escapeCharactersCallback);\n\n text = globals.converter._dispatch('makehtml.encodeBackslashEscapes.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/encodeCode.js",
"content": "/**\n * Encode/escape certain characters inside Markdown code runs.\n * The point is that in code, these characters are literals,\n * and lose their special Markdown meanings.\n */\nshowdown.subParser('makehtml.encodeCode', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.encodeCode.before', text, options, globals).getText();\n\n // Encode all ampersands; HTML entities are not\n // entities within a Markdown code span.\n text = text\n .replace(/&/g, '&')\n // Do the angle bracket song and dance:\n .replace(//g, '>')\n // Now, escape characters that are magic in Markdown:\n .replace(/([*_{}\\[\\]\\\\=~-])/g, showdown.helper.escapeCharactersCallback);\n\n text = globals.converter._dispatch('makehtml.encodeCode.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/escapeSpecialCharsWithinTagAttributes.js",
"content": "/**\n * Within tags -- meaning between < and > -- encode [\\ ` * _ ~ =] so they\n * don't conflict with their use in Markdown for code, italics and strong.\n */\nshowdown.subParser('makehtml.escapeSpecialCharsWithinTagAttributes', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.escapeSpecialCharsWithinTagAttributes.before', text, options, globals).getText();\n\n // Build a regex to find HTML tags.\n var tags = /<\\/?[a-z\\d_:-]+(?:[\\s]+[\\s\\S]+?)?>/gi,\n comments = /-]|-[^>])(?:[^-]|-[^-])*)--)>/gi;\n\n text = text.replace(tags, function (wholeMatch) {\n return wholeMatch\n .replace(/(.)<\\/?code>(?=.)/g, '$1`')\n .replace(/([\\\\`*_~=|])/g, showdown.helper.escapeCharactersCallback);\n });\n\n text = text.replace(comments, function (wholeMatch) {\n return wholeMatch\n .replace(/([\\\\`*_~=|])/g, showdown.helper.escapeCharactersCallback);\n });\n\n text = globals.converter._dispatch('makehtml.escapeSpecialCharsWithinTagAttributes.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/githubCodeBlocks.js",
"content": "/**\n * Handle github codeblocks prior to running HashHTML so that\n * HTML contained within the codeblock gets escaped properly\n * Example:\n * ```ruby\n * def hello_world(x)\n * puts \"Hello, #{x}\"\n * end\n * ```\n */\nshowdown.subParser('makehtml.githubCodeBlocks', function (text, options, globals) {\n 'use strict';\n\n // early exit if option is not enabled\n if (!options.ghCodeBlocks) {\n return text;\n }\n\n text = globals.converter._dispatch('makehtml.githubCodeBlocks.before', text, options, globals).getText();\n\n text += '¨0';\n\n text = text.replace(/(?:^|\\n) {0,3}(```+|~~~+) *([^\\n\\t`~]*)\\n([\\s\\S]*?)\\n {0,3}\\1/g, function (wholeMatch, delim, language, codeblock) {\n var end = (options.omitExtraWLInCodeBlocks) ? '' : '\\n';\n\n // if the language has spaces followed by some other chars, according to the spec we should just ignore everything\n // after the first space\n language = language.trim().split(' ')[0];\n\n // First parse the github code block\n codeblock = showdown.subParser('makehtml.encodeCode')(codeblock, options, globals);\n codeblock = showdown.subParser('makehtml.detab')(codeblock, options, globals);\n codeblock = codeblock.replace(/^\\n+/g, ''); // trim leading newlines\n codeblock = codeblock.replace(/\\n+$/g, ''); // trim trailing whitespace\n\n codeblock = '' + codeblock + end + '
';\n\n codeblock = showdown.subParser('makehtml.hashBlock')(codeblock, options, globals);\n\n // Since GHCodeblocks can be false positives, we need to\n // store the primitive text and the parsed text in a global var,\n // and then return a token\n return '\\n\\n¨G' + (globals.ghCodeBlocks.push({text: wholeMatch, codeblock: codeblock}) - 1) + 'G\\n\\n';\n });\n\n // attacklab: strip sentinel\n text = text.replace(/¨0/, '');\n\n return globals.converter._dispatch('makehtml.githubCodeBlocks.after', text, options, globals).getText();\n});\n"
},
{
"path": "src/subParsers/makehtml/hashBlock.js",
"content": "showdown.subParser('makehtml.hashBlock', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.hashBlock.before', text, options, globals).getText();\n text = text.replace(/(^\\n+|\\n+$)/g, '');\n text = '\\n\\n¨K' + (globals.gHtmlBlocks.push(text) - 1) + 'K\\n\\n';\n text = globals.converter._dispatch('makehtml.hashBlock.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/hashCodeTags.js",
"content": "/**\n * Hash and escape elements that should not be parsed as markdown\n */\nshowdown.subParser('makehtml.hashCodeTags', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.hashCodeTags.before', text, options, globals).getText();\n\n var repFunc = function (wholeMatch, match, left, right) {\n var codeblock = left + showdown.subParser('makehtml.encodeCode')(match, options, globals) + right;\n return '¨C' + (globals.gHtmlSpans.push(codeblock) - 1) + 'C';\n };\n\n // Hash naked \n text = showdown.helper.replaceRecursiveRegExp(text, repFunc, ']*>', ' ', 'gim');\n\n text = globals.converter._dispatch('makehtml.hashCodeTags.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/hashElement.js",
"content": "showdown.subParser('makehtml.hashElement', function (text, options, globals) {\n 'use strict';\n\n return function (wholeMatch, m1) {\n var blockText = m1;\n\n // Undo double lines\n blockText = blockText.replace(/\\n\\n/g, '\\n');\n blockText = blockText.replace(/^\\n/, '');\n\n // strip trailing blank lines\n blockText = blockText.replace(/\\n+$/g, '');\n\n // Replace the element text with a marker (\"¨KxK\" where x is its key)\n blockText = '\\n\\n¨K' + (globals.gHtmlBlocks.push(blockText) - 1) + 'K\\n\\n';\n\n return blockText;\n };\n});\n"
},
{
"path": "src/subParsers/makehtml/hashHTMLBlocks.js",
"content": "showdown.subParser('makehtml.hashHTMLBlocks', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.hashHTMLBlocks.before', text, options, globals).getText();\n\n var blockTags = [\n 'pre',\n 'div',\n 'h1',\n 'h2',\n 'h3',\n 'h4',\n 'h5',\n 'h6',\n 'blockquote',\n 'table',\n 'dl',\n 'ol',\n 'ul',\n 'script',\n 'noscript',\n 'form',\n 'fieldset',\n 'iframe',\n 'math',\n 'style',\n 'section',\n 'header',\n 'footer',\n 'nav',\n 'article',\n 'aside',\n 'address',\n 'audio',\n 'canvas',\n 'figure',\n 'hgroup',\n 'output',\n 'video',\n 'details',\n 'p'\n ],\n repFunc = function (wholeMatch, match, left, right) {\n var txt = wholeMatch;\n // check if this html element is marked as markdown\n // if so, it's contents should be parsed as markdown\n if (left.search(/\\bmarkdown\\b/) !== -1) {\n txt = left + globals.converter.makeHtml(match) + right;\n }\n return '\\n\\n¨K' + (globals.gHtmlBlocks.push(txt) - 1) + 'K\\n\\n';\n };\n\n if (options.backslashEscapesHTMLTags) {\n // encode backslash escaped HTML tags\n text = text.replace(/\\\\<(\\/?[^>]+?)>/g, function (wm, inside) {\n return '<' + inside + '>';\n });\n }\n\n // hash HTML Blocks\n for (var i = 0; i < blockTags.length; ++i) {\n\n var opTagPos,\n rgx1 = new RegExp('^ {0,3}(<' + blockTags[i] + '\\\\b[^>]*>)', 'im'),\n patLeft = '<' + blockTags[i] + '\\\\b[^>]*>',\n patRight = '';\n // 1. Look for the first position of the first opening HTML tag in the text\n while ((opTagPos = showdown.helper.regexIndexOf(text, rgx1)) !== -1) {\n\n // if the HTML tag is \\ escaped, we need to escape it and break\n\n\n //2. Split the text in that position\n var subTexts = showdown.helper.splitAtIndex(text, opTagPos),\n //3. Match recursively\n newSubText1 = showdown.helper.replaceRecursiveRegExp(subTexts[1], repFunc, patLeft, patRight, 'im');\n\n // prevent an infinite loop\n if (newSubText1 === subTexts[1]) {\n break;\n }\n text = subTexts[0].concat(newSubText1);\n }\n }\n // HR SPECIAL CASE\n text = text.replace(/(\\n {0,3}(<(hr)\\b([^<>])*?\\/?>)[ \\t]*(?=\\n{2,}))/g,\n showdown.subParser('makehtml.hashElement')(text, options, globals));\n\n // Special case for standalone HTML comments\n text = showdown.helper.replaceRecursiveRegExp(text, function (txt) {\n return '\\n\\n¨K' + (globals.gHtmlBlocks.push(txt) - 1) + 'K\\n\\n';\n }, '^ {0,3}', 'gm');\n\n // PHP and ASP-style processor instructions ( and <%...%>)\n text = text.replace(/\\n\\n( {0,3}<([?%])[^\\r]*?\\2>[ \\t]*(?=\\n{2,}))/g,\n showdown.subParser('makehtml.hashElement')(text, options, globals));\n\n text = globals.converter._dispatch('makehtml.hashHTMLBlocks.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/hashHTMLSpans.js",
"content": "/**\n * Hash span elements that should not be parsed as markdown\n */\nshowdown.subParser('makehtml.hashHTMLSpans', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.hashHTMLSpans.before', text, options, globals).getText();\n\n // Hash Self Closing tags\n text = text.replace(/<[^>]+?\\/>/gi, function (wm) {\n return showdown.helper._hashHTMLSpan(wm, globals);\n });\n\n // Hash tags without properties\n text = text.replace(/<([^>]+?)>[\\s\\S]*?<\\/\\1>/g, function (wm) {\n return showdown.helper._hashHTMLSpan(wm, globals);\n });\n\n // Hash tags with properties\n text = text.replace(/<([^>]+?)\\s[^>]+?>[\\s\\S]*?<\\/\\1>/g, function (wm) {\n return showdown.helper._hashHTMLSpan(wm, globals);\n });\n\n // Hash self closing tags without />\n text = text.replace(/<[^>]+?>/gi, function (wm) {\n return showdown.helper._hashHTMLSpan(wm, globals);\n });\n\n text = globals.converter._dispatch('makehtml.hashHTMLSpans.after', text, options, globals).getText();\n return text;\n});\n\n/**\n * Unhash HTML spans\n */\nshowdown.subParser('makehtml.unhashHTMLSpans', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.unhashHTMLSpans.before', text, options, globals).getText();\n\n for (var i = 0; i < globals.gHtmlSpans.length; ++i) {\n var repText = globals.gHtmlSpans[i],\n // limiter to prevent infinite loop (assume 10 as limit for recurse)\n limit = 0;\n\n while (/¨C(\\d+)C/.test(repText)) {\n var num = RegExp.$1;\n repText = repText.replace('¨C' + num + 'C', globals.gHtmlSpans[num]);\n if (limit === 10) {\n console.error('maximum nesting of 10 spans reached!!!');\n break;\n }\n ++limit;\n }\n text = text.replace('¨C' + i + 'C', repText);\n }\n\n text = globals.converter._dispatch('makehtml.unhashHTMLSpans.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/hashPreCodeTags.js",
"content": "/**\n * Hash and escape elements that should not be parsed as markdown\n */\nshowdown.subParser('makehtml.hashPreCodeTags', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.hashPreCodeTags.before', text, options, globals).getText();\n\n var repFunc = function (wholeMatch, match, left, right) {\n // encode html entities\n var codeblock = left + showdown.subParser('makehtml.encodeCode')(match, options, globals) + right;\n return '\\n\\n¨G' + (globals.ghCodeBlocks.push({text: wholeMatch, codeblock: codeblock}) - 1) + 'G\\n\\n';\n };\n\n // Hash \n text = showdown.helper.replaceRecursiveRegExp(text, repFunc, '^ {0,3}]*>\\\\s*]*>', '^ {0,3} \\\\s*
', 'gim');\n\n text = globals.converter._dispatch('makehtml.hashPreCodeTags.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/headers.js",
"content": "showdown.subParser('makehtml.headers', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.headers.before', text, options, globals).getText();\n\n var headerLevelStart = (isNaN(parseInt(options.headerLevelStart))) ? 1 : parseInt(options.headerLevelStart),\n\n // Set text-style headers:\n //\tHeader 1\n //\t========\n //\n //\tHeader 2\n //\t--------\n //\n setextRegexH1 = (options.smoothLivePreview) ? /^(.+)[ \\t]*\\n={2,}[ \\t]*\\n+/gm : /^(.+)[ \\t]*\\n=+[ \\t]*\\n+/gm,\n setextRegexH2 = (options.smoothLivePreview) ? /^(.+)[ \\t]*\\n-{2,}[ \\t]*\\n+/gm : /^(.+)[ \\t]*\\n-+[ \\t]*\\n+/gm;\n\n text = text.replace(setextRegexH1, function (wholeMatch, m1) {\n\n var spanGamut = showdown.subParser('makehtml.spanGamut')(m1, options, globals),\n hID = (options.noHeaderId) ? '' : ' id=\"' + headerId(m1) + '\"',\n hLevel = headerLevelStart,\n hashBlock = '' + spanGamut + ' ';\n return showdown.subParser('makehtml.hashBlock')(hashBlock, options, globals);\n });\n\n text = text.replace(setextRegexH2, function (matchFound, m1) {\n var spanGamut = showdown.subParser('makehtml.spanGamut')(m1, options, globals),\n hID = (options.noHeaderId) ? '' : ' id=\"' + headerId(m1) + '\"',\n hLevel = headerLevelStart + 1,\n hashBlock = '' + spanGamut + ' ';\n return showdown.subParser('makehtml.hashBlock')(hashBlock, options, globals);\n });\n\n // atx-style headers:\n // # Header 1\n // ## Header 2\n // ## Header 2 with closing hashes ##\n // ...\n // ###### Header 6\n //\n var atxStyle = (options.requireSpaceBeforeHeadingText) ? /^(#{1,6})[ \\t]+(.+?)[ \\t]*#*\\n+/gm : /^(#{1,6})[ \\t]*(.+?)[ \\t]*#*\\n+/gm;\n\n text = text.replace(atxStyle, function (wholeMatch, m1, m2) {\n var hText = m2;\n if (options.customizedHeaderId) {\n hText = m2.replace(/\\s?{([^{]+?)}\\s*$/, '');\n }\n\n var span = showdown.subParser('makehtml.spanGamut')(hText, options, globals),\n hID = (options.noHeaderId) ? '' : ' id=\"' + headerId(m2) + '\"',\n hLevel = headerLevelStart - 1 + m1.length,\n header = '' + span + ' ';\n\n return showdown.subParser('makehtml.hashBlock')(header, options, globals);\n });\n\n function headerId (m) {\n var title,\n prefix;\n\n // It is separate from other options to allow combining prefix and customized\n if (options.customizedHeaderId) {\n var match = m.match(/{([^{]+?)}\\s*$/);\n if (match && match[1]) {\n m = match[1];\n }\n }\n\n title = m;\n\n // Prefix id to prevent causing inadvertent pre-existing style matches.\n if (showdown.helper.isString(options.prefixHeaderId)) {\n prefix = options.prefixHeaderId;\n } else if (options.prefixHeaderId === true) {\n prefix = 'section-';\n } else {\n prefix = '';\n }\n\n if (!options.rawPrefixHeaderId) {\n title = prefix + title;\n }\n\n if (options.ghCompatibleHeaderId) {\n title = title\n .replace(/ /g, '-')\n // replace previously escaped chars (&, ¨ and $)\n .replace(/&/g, '')\n .replace(/¨T/g, '')\n .replace(/¨D/g, '')\n // replace rest of the chars (&~$ are repeated as they might have been escaped)\n // borrowed from github's redcarpet (some they should produce similar results)\n .replace(/[&+$,\\/:;=?@\"#{}|^¨~\\[\\]`\\\\*)(%.!'<>]/g, '')\n .toLowerCase();\n } else if (options.rawHeaderId) {\n title = title\n .replace(/ /g, '-')\n // replace previously escaped chars (&, ¨ and $)\n .replace(/&/g, '&')\n .replace(/¨T/g, '¨')\n .replace(/¨D/g, '$')\n // replace \" and '\n .replace(/[\"']/g, '-')\n .toLowerCase();\n } else {\n title = title\n .replace(/[^\\w]/g, '')\n .toLowerCase();\n }\n\n if (options.rawPrefixHeaderId) {\n title = prefix + title;\n }\n\n if (globals.hashLinkCounts[title]) {\n title = title + '-' + (globals.hashLinkCounts[title]++);\n } else {\n globals.hashLinkCounts[title] = 1;\n }\n return title;\n }\n\n text = globals.converter._dispatch('makehtml.headers.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/horizontalRule.js",
"content": "/**\n * Turn Markdown horizontal rule shortcuts into
tags.\n *\n * Any 3 or more unindented consecutive hyphens, asterisks or underscores with or without a space beetween them\n * in a single line is considered a horizontal rule\n */\nshowdown.subParser('makehtml.horizontalRule', function (text, options, globals) {\n 'use strict';\n text = globals.converter._dispatch('makehtml.horizontalRule.before', text, options, globals).getText();\n\n var key = showdown.subParser('makehtml.hashBlock')('
', options, globals);\n text = text.replace(/^ {0,2}( ?-){3,}[ \\t]*$/gm, key);\n text = text.replace(/^ {0,2}( ?\\*){3,}[ \\t]*$/gm, key);\n text = text.replace(/^ {0,2}( ?_){3,}[ \\t]*$/gm, key);\n\n text = globals.converter._dispatch('makehtml.horizontalRule.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/images.js",
"content": "/**\n * Turn Markdown image shortcuts into ![]()
tags.\n */\nshowdown.subParser('makehtml.images', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.images.before', text, options, globals).getText();\n\n var inlineRegExp = /!\\[([^\\]]*?)][ \\t]*()\\([ \\t]??(?: =([*\\d]+[A-Za-z%]{0,4})x([*\\d]+[A-Za-z%]{0,4}))?[ \\t]*(?:([\"'])([^\"]*?)\\6)?[ \\t]?\\)/g,\n crazyRegExp = /!\\[([^\\]]*?)][ \\t]*()\\([ \\t]?<([^>]*)>(?: =([*\\d]+[A-Za-z%]{0,4})x([*\\d]+[A-Za-z%]{0,4}))?[ \\t]*(?:(?:([\"'])([^\"]*?)\\6))?[ \\t]?\\)/g,\n base64RegExp = /!\\[([^\\]]*?)][ \\t]*()\\([ \\t]??(?: =([*\\d]+[A-Za-z%]{0,4})x([*\\d]+[A-Za-z%]{0,4}))?[ \\t]*(?:([\"'])([^\"]*?)\\6)?[ \\t]?\\)/g,\n referenceRegExp = /!\\[([^\\]]*?)] ?(?:\\n *)?\\[([\\s\\S]*?)]()()()()()/g,\n refShortcutRegExp = /!\\[([^\\[\\]]+)]()()()()()/g;\n\n function writeImageTagBase64 (wholeMatch, altText, linkId, url, width, height, m5, title) {\n url = url.replace(/\\s/g, '');\n return writeImageTag (wholeMatch, altText, linkId, url, width, height, m5, title);\n }\n\n function writeImageTagBaseUrl (wholeMatch, altText, linkId, url, width, height, m5, title) {\n url = showdown.helper.applyBaseUrl(options.relativePathBaseUrl, url);\n\n return writeImageTag (wholeMatch, altText, linkId, url, width, height, m5, title);\n }\n\n function writeImageTag (wholeMatch, altText, linkId, url, width, height, m5, title) {\n\n var gUrls = globals.gUrls,\n gTitles = globals.gTitles,\n gDims = globals.gDimensions;\n\n linkId = linkId.toLowerCase();\n\n if (!title) {\n title = '';\n }\n // Special case for explicit empty url\n if (wholeMatch.search(/\\(? ?(['\"].*['\"])?\\)$/m) > -1) {\n url = '';\n\n } else if (url === '' || url === null) {\n if (linkId === '' || linkId === null) {\n // lower-case and turn embedded newlines into spaces\n linkId = altText.toLowerCase().replace(/ ?\\n/g, ' ');\n }\n url = '#' + linkId;\n\n if (!showdown.helper.isUndefined(gUrls[linkId])) {\n url = gUrls[linkId];\n if (!showdown.helper.isUndefined(gTitles[linkId])) {\n title = gTitles[linkId];\n }\n if (!showdown.helper.isUndefined(gDims[linkId])) {\n width = gDims[linkId].width;\n height = gDims[linkId].height;\n }\n } else {\n return wholeMatch;\n }\n }\n\n altText = altText\n .replace(/\"/g, '"')\n //altText = showdown.helper.escapeCharacters(altText, '*_', false);\n .replace(showdown.helper.regexes.asteriskDashTildeAndColon, showdown.helper.escapeCharactersCallback);\n //url = showdown.helper.escapeCharacters(url, '*_', false);\n url = url.replace(showdown.helper.regexes.asteriskDashTildeAndColon, showdown.helper.escapeCharactersCallback);\n var result = '![\"'](\"' "title\n")
x \"optional title\")\n\n // base64 encoded images\n text = text.replace(base64RegExp, writeImageTagBase64);\n\n // cases with crazy urls like ./image/cat1).png\n text = text.replace(crazyRegExp, writeImageTagBaseUrl);\n\n // normal cases\n text = text.replace(inlineRegExp, writeImageTagBaseUrl);\n\n // handle reference-style shortcuts: ![img text]\n text = text.replace(refShortcutRegExp, writeImageTag);\n\n text = globals.converter._dispatch('makehtml.images.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/italicsAndBold.js",
"content": "showdown.subParser('makehtml.italicsAndBold', function (text, options, globals) {\n 'use strict';\n\n text = globals.converter._dispatch('makehtml.italicsAndBold.before', text, options, globals).getText();\n\n // it's faster to have 3 separate regexes for each case than have just one\n // because of backtracing, in some cases, it could lead to an exponential effect\n // called \"catastrophic backtrace\". Ominous!\n\n function parseInside (txt, left, right) {\n return left + txt + right;\n }\n\n // Parse underscores\n if (options.literalMidWordUnderscores) {\n text = text.replace(/\\b___(\\S[\\s\\S]*?)___\\b/g, function (wm, txt) {\n return parseInside (txt, '', '');\n });\n text = text.replace(/\\b__(\\S[\\s\\S]*?)__\\b/g, function (wm, txt) {\n return parseInside (txt, '', '');\n });\n text = text.replace(/\\b_(\\S[\\s\\S]*?)_\\b/g, function (wm, txt) {\n return parseInside (txt, '', '');\n });\n } else {\n text = text.replace(/___(\\S[\\s\\S]*?)___/g, function (wm, m) {\n return (/\\S$/.test(m)) ? parseInside (m, '', '') : wm;\n });\n text = text.replace(/__(\\S[\\s\\S]*?)__/g, function (wm, m) {\n return (/\\S$/.test(m)) ? parseInside (m, '', '') : wm;\n });\n text = text.replace(/_([^\\s_][\\s\\S]*?)_/g, function (wm, m) {\n // !/^_[^_]/.test(m) - test if it doesn't start with __ (since it seems redundant, we removed it)\n return (/\\S$/.test(m)) ? parseInside (m, '', '') : wm;\n });\n }\n\n // Now parse asterisks\n /*\n if (options.literalMidWordAsterisks) {\n text = text.replace(/([^*]|^)\\B\\*\\*\\*(\\S[\\s\\S]+?)\\*\\*\\*\\B(?!\\*)/g, function (wm, lead, txt) {\n return parseInside (txt, lead + '', '');\n });\n text = text.replace(/([^*]|^)\\B\\*\\*(\\S[\\s\\S]+?)\\*\\*\\B(?!\\*)/g, function (wm, lead, txt) {\n return parseInside (txt, lead + '', '');\n });\n text = text.replace(/([^*]|^)\\B\\*(\\S[\\s\\S]+?)\\*\\B(?!\\*)/g, function (wm, lead, txt) {\n return parseInside (txt, lead + '', '');\n });\n } else {\n */\n text = text.replace(/\\*\\*\\*(\\S[\\s\\S]*?)\\*\\*\\*/g, function (wm, m) {\n return (/\\S$/.test(m)) ? parseInside (m, '', '') : wm;\n });\n text = text.replace(/\\*\\*(\\S[\\s\\S]*?)\\*\\*/g, function (wm, m) {\n return (/\\S$/.test(m)) ? parseInside (m, '', '') : wm;\n });\n text = text.replace(/\\*([^\\s*][\\s\\S]*?)\\*/g, function (wm, m) {\n // !/^\\*[^*]/.test(m) - test if it doesn't start with ** (since it seems redundant, we removed it)\n return (/\\S$/.test(m)) ? parseInside (m, '', '') : wm;\n });\n //}\n\n text = globals.converter._dispatch('makehtml.italicsAndBold.after', text, options, globals).getText();\n return text;\n});\n"
},
{
"path": "src/subParsers/makehtml/links.js",
"content": "////\n// makehtml/links.js\n// Copyright (c) 2018 ShowdownJS\n//\n// Transforms MD links into `` html anchors\n//\n// A link contains link text (the visible text), a link destination (the URI that is the link destination), and\n// optionally a link title. There are two basic kinds of links in Markdown.\n// In inline links the destination and title are given immediately after the link text.\n// In reference links the destination and title are defined elsewhere in the document.\n//\n// ***Author:***\n// - Estevão Soares dos Santos (Tivie) \n////\n\n(function () {\n /**\n * Helper function: Wrapper function to pass as second replace parameter\n *\n * @param {RegExp} rgx\n * @param {string} evtRootName\n * @param {{}} options\n * @param {{}} globals\n * @returns {Function}\n */\n function replaceAnchorTagReference (rgx, evtRootName, options, globals, emptyCase) {\n emptyCase = !!emptyCase;\n return function (wholeMatch, text, id, url, m5, m6, title) {\n // bail we we find 2 newlines somewhere\n if (/\\n\\n/.test(wholeMatch)) {\n return wholeMatch;\n }\n\n var evt = createEvent(rgx, evtRootName + '.captureStart', wholeMatch, text, id, url, title, options, globals);\n return writeAnchorTag(evt, options, globals, emptyCase);\n };\n }\n\n function replaceAnchorTagBaseUrl (rgx, evtRootName, options, globals, emptyCase) {\n return function (wholeMatch, text, id, url, m5, m6, title) {\n url = showdown.helper.applyBaseUrl(options.relativePathBaseUrl, url);\n\n var evt = createEvent(rgx, evtRootName + '.captureStart', wholeMatch, text, id, url, title, options, globals);\n return writeAnchorTag(evt, options, globals, emptyCase);\n };\n }\n\n /**\n * TODO Normalize this\n * Helper function: Create a capture event\n * @param {RegExp} rgx\n * @param {String} evtName Event name\n * @param {String} wholeMatch\n * @param {String} text\n * @param {String} id\n * @param {String} url\n * @param {String} title\n * @param {{}} options\n * @param {{}} globals\n * @returns {showdown.helper.Event|*}\n */\n function createEvent (rgx, evtName, wholeMatch, text, id, url, title, options, globals) {\n return globals.converter._dispatch(evtName, wholeMatch, options, globals, {\n regexp: rgx,\n matches: {\n wholeMatch: wholeMatch,\n text: text,\n id: id,\n url: url,\n title: title\n }\n });\n }\n\n /**\n * Helper Function: Normalize and write an anchor tag based on passed parameters\n * @param evt\n * @param options\n * @param globals\n * @param {boolean} emptyCase\n * @returns {string}\n */\n function writeAnchorTag (evt, options, globals, emptyCase) {\n\n var wholeMatch = evt.getMatches().wholeMatch;\n var text = evt.getMatches().text;\n var id = evt.getMatches().id;\n var url = evt.getMatches().url;\n var title = evt.getMatches().title;\n var target = '';\n\n if (!title) {\n title = '';\n }\n id = (id) ? id.toLowerCase() : '';\n\n if (emptyCase) {\n url = '';\n } else if (!url) {\n if (!id) {\n // lower-case and turn embedded newlines into spaces\n id = text.toLowerCase().replace(/ ?\\n/g, ' ');\n }\n url = '#' + id;\n\n if (!showdown.helper.isUndefined(globals.gUrls[id])) {\n url = globals.gUrls[id];\n if (!showdown.helper.isUndefined(globals.gTitles[id])) {\n title = globals.gTitles[id];\n }\n } else {\n return wholeMatch;\n }\n }\n //url = showdown.helper.escapeCharacters(url, '*_:~', false); // replaced line to improve performance\n url = url.replace(showdown.helper.regexes.asteriskDashTildeAndColon, showdown.helper.escapeCharactersCallback);\n\n if (title !== '' && title !== null) {\n title = title.replace(/\"/g, '"');\n //title = showdown.helper.escapeCharacters(title, '*_', false); // replaced line to improve performance\n title = title.replace(showdown.helper.regexes.asteriskDashTildeAndColon, showdown.helper.escapeCharactersCallback);\n title = ' title=\"' + title + '\"';\n }\n\n // optionLinksInNewWindow only applies\n // to external links. Hash links (#) open in same page\n if (options.openLinksInNewWindow && !/^#/.test(url)) {\n // escaped _\n target = ' rel=\"noopener noreferrer\" target=\"¨E95Eblank\"';\n }\n\n // Text can be a markdown element, so we run through the appropriate parsers\n text = showdown.subParser('makehtml.codeSpans')(text, options, globals);\n text = showdown.subParser('makehtml.emoji')(text, options, globals);\n text = showdown.subParser('makehtml.underline')(text, options, globals);\n text = showdown.subParser('makehtml.italicsAndBold')(text, options, globals);\n text = showdown.subParser('makehtml.strikethrough')(text, options, globals);\n text = showdown.subParser('makehtml.ellipsis')(text, options, globals);\n text = showdown.subParser('makehtml.hashHTMLSpans')(text, options, globals);\n\n //evt = createEvent(rgx, evtRootName + '.captureEnd', wholeMatch, text, id, url, title, options, globals);\n\n var result = '' + text + '';\n\n //evt = createEvent(rgx, evtRootName + '.beforeHash', wholeMatch, text, id, url, title, options, globals);\n\n result = showdown.subParser('makehtml.hashHTMLSpans')(result, options, globals);\n\n return result;\n }\n\n var evtRootName = 'makehtml.links';\n\n /**\n * Turn Markdown link shortcuts into XHTML tags.\n */\n showdown.subParser('makehtml.links', function (text, options, globals) {\n\n text = globals.converter._dispatch(evtRootName + '.start', text, options, globals).getText();\n\n // 1. Handle reference-style links: [link text] [id]\n text = showdown.subParser('makehtml.links.reference')(text, options, globals);\n\n // 2. Handle inline-style links: [link text](url \"optional title\")\n text = showdown.subParser('makehtml.links.inline')(text, options, globals);\n\n // 3. Handle reference-style shortcuts: [link text]\n // These must come last in case there's a [link text][1] or [link text](/foo)\n text = showdown.subParser('makehtml.links.referenceShortcut')(text, options, globals);\n\n // 4. Handle angle brackets links -> `).\n text = showdown.subParser('makehtml.links.angleBrackets')(text, options, globals);\n\n // 5. Handle GithubMentions (if option is enabled)\n text = showdown.subParser('makehtml.links.ghMentions')(text, options, globals);\n\n // 6. Handle tags and img tags\n text = text.replace(/]*>[\\s\\S]*<\\/a>/g, function (wholeMatch) {\n return showdown.helper._hashHTMLSpan(wholeMatch, globals);\n });\n\n text = text.replace(/]*\\/?>/g, function (wholeMatch) {\n return showdown.helper._hashHTMLSpan(wholeMatch, globals);\n });\n\n // 7. Handle naked links (if option is enabled)\n text = showdown.subParser('makehtml.links.naked')(text, options, globals);\n\n text = globals.converter._dispatch(evtRootName + '.end', text, options, globals).getText();\n return text;\n });\n\n /**\n * TODO WRITE THIS DOCUMENTATION\n */\n showdown.subParser('makehtml.links.inline', function (text, options, globals) {\n var evtRootName = evtRootName + '.inline';\n\n text = globals.converter._dispatch(evtRootName + '.start', text, options, globals).getText();\n\n // 1. Look for empty cases: []() and [empty]() and [](\"title\")\n var rgxEmpty = /\\[(.*?)]()()()()\\(? ?(?:[\"'](.*)[\"'])?\\)/g;\n text = text.replace(rgxEmpty, replaceAnchorTagBaseUrl(rgxEmpty, evtRootName, options, globals, true));\n\n // 2. Look for cases with crazy urls like ./image/cat1).png\n var rgxCrazy = /\\[((?:\\[[^\\]]*]|[^\\[\\]])*)]()\\s?\\([ \\t]?<([^>]*)>(?:[ \\t]*(([\"'])([^\"]*?)\\5))?[ \\t]?\\)/g;\n text = text.replace(rgxCrazy, replaceAnchorTagBaseUrl(rgxCrazy, evtRootName, options, globals));\n\n // 3. inline links with no title or titles wrapped in ' or \":\n // [text](url.com) || [text]() || [text](url.com \"title\") || [text]( \"title\")\n //var rgx2 = /\\[[ ]*[\\s]?[ ]*([^\\n\\[\\]]*?)[ ]*[\\s]?[ ]*] ?()\\(?(?:[ ]*[\\n]?[ ]*()(['\"])(.*?)\\5)?[ ]*[\\s]?[ ]*\\)/; // this regex is too slow!!!\n var rgx2 = /\\[([\\S ]*?)]\\s?()\\( *?\\s*(?:()(['\"])(.*?)\\5)? *\\)/g;\n text = text.replace(rgx2, replaceAnchorTagBaseUrl(rgx2, evtRootName, options, globals));\n\n // 4. inline links with titles wrapped in (): [foo](bar.com (title))\n var rgx3 = /\\[([\\S ]*?)]\\s?()\\( *?\\s+()()\\((.*?)\\) *\\)/g;\n text = text.replace(rgx3, replaceAnchorTagBaseUrl(rgx3, evtRootName, options, globals));\n\n text = globals.converter._dispatch(evtRootName + '.end', text, options, globals).getText();\n\n return text;\n });\n\n /**\n * TODO WRITE THIS DOCUMENTATION\n */\n showdown.subParser('makehtml.links.reference', function (text, options, globals) {\n var evtRootName = evtRootName + '.reference';\n\n text = globals.converter._dispatch(evtRootName + '.start', text, options, globals).getText();\n\n var rgx = /\\[((?:\\[[^\\]]*]|[^\\[\\]])*)] ?(?:\\n *)?\\[(.*?)]()()()()/g;\n text = text.replace(rgx, replaceAnchorTagReference(rgx, evtRootName, options, globals));\n\n text = globals.converter._dispatch(evtRootName + '.end', text, options, globals).getText();\n\n return text;\n });\n\n /**\n * TODO WRITE THIS DOCUMENTATION\n */\n showdown.subParser('makehtml.links.referenceShortcut', function (text, options, globals) {\n var evtRootName = evtRootName + '.referenceShortcut';\n\n text = globals.converter._dispatch(evtRootName + '.start', text, options, globals).getText();\n\n var rgx = /\\[([^\\[\\]]+)]()()()()()/g;\n text = text.replace(rgx, replaceAnchorTagReference(rgx, evtRootName, options, globals));\n\n text = globals.converter._dispatch(evtRootName + '.end', text, options, globals).getText();\n\n return text;\n });\n\n /**\n * TODO WRITE THIS DOCUMENTATION\n */\n showdown.subParser('makehtml.links.ghMentions', function (text, options, globals) {\n var evtRootName = evtRootName + 'ghMentions';\n\n if (!options.ghMentions) {\n return text;\n }\n\n text = globals.converter._dispatch(evtRootName + '.start', text, options, globals).getText();\n\n var rgx = /(^|\\s)(\\\\)?(@([a-z\\d]+(?:[a-z\\d._-]+?[a-z\\d]+)*))/gi;\n\n text = text.replace(rgx, function (wholeMatch, st, escape, mentions, username) {\n // bail if the mentions was escaped\n if (escape === '\\\\') {\n return st + mentions;\n }\n\n // check if options.ghMentionsLink is a string\n // TODO Validation should be done at initialization not at runtime\n if (!showdown.helper.isString(options.ghMentionsLink)) {\n throw new Error('ghMentionsLink option must be a string');\n }\n var url = options.ghMentionsLink.replace(/{u}/g, username);\n var evt = createEvent(rgx, evtRootName + '.captureStart', wholeMatch, mentions, null, url, null, options, globals);\n // captureEnd Event is triggered inside writeAnchorTag function\n return st + writeAnchorTag(evt, options, globals);\n });\n\n text = globals.converter._dispatch(evtRootName + '.end', text, options, globals).getText();\n\n return text;\n });\n\n /**\n * TODO WRITE THIS DOCUMENTATION\n */\n showdown.subParser('makehtml.links.angleBrackets', function (text, options, globals) {\n var evtRootName = 'makehtml.links.angleBrackets';\n\n text = globals.converter._dispatch(evtRootName + '.start', text, options, globals).getText();\n\n // 1. Parse links first\n var urlRgx = /<(((?:https?|ftp):\\/\\/|www\\.)[^'\">\\s]+)>/gi;\n text = text.replace(urlRgx, function (wholeMatch, url, urlStart) {\n var text = url;\n url = (urlStart === 'www.') ? 'http://' + url : url;\n var evt = createEvent(urlRgx, evtRootName + '.captureStart', wholeMatch, text, null, url, null, options, globals);\n return writeAnchorTag(evt, options, globals);\n });\n\n // 2. Then Mail Addresses\n var mailRgx = /<(?:mailto:)?([-.\\w]+@[-a-z0-9]+(\\.[-a-z0-9]+)*\\.[a-z]+)>/gi;\n text = text.replace(mailRgx, function (wholeMatch, mail) {\n var url = 'mailto:';\n mail = showdown.subParser('makehtml.unescapeSpecialChars')(mail, options, globals);\n if (options.encodeEmails) {\n url = showdown.helper.encodeEmailAddress(url + mail);\n mail = showdown.helper.encodeEmailAddress(mail);\n } else {\n url = url + mail;\n }\n var evt = createEvent(mailRgx, evtRootName + '.captureStart', wholeMatch, mail, null, url, null, options, globals);\n return writeAnchorTag(evt, options, globals);\n });\n\n text = globals.converter._dispatch(evtRootName + '.end', text, options, globals).getText();\n return text;\n });\n\n /**\n * TODO MAKE THIS WORK (IT'S NOT ACTIVATED)\n * TODO WRITE THIS DOCUMENTATION\n */\n showdown.subParser('makehtml.links.naked', function (text, options, globals) {\n if (!options.simplifiedAutoLink) {\n return text;\n }\n\n var evtRootName = 'makehtml.links.naked';\n\n text = globals.converter._dispatch(evtRootName + '.start', text, options, globals).getText();\n\n // 2. Now we check for\n // we also include leading markdown magic chars [_*~] for cases like __https://www.google.com/foobar__\n var urlRgx = /([_*~]*?)(((?:https?|ftp):\\/\\/|www\\.)[^\\s<>\"'`´.-][^\\s<>\"'`´]*?\\.[a-z\\d.]+[^\\s<>\"']*)\\1/gi;\n text = text.replace(urlRgx, function (wholeMatch, leadingMDChars, url, urlPrefix) {\n\n // we now will start traversing the url from the front to back, looking for punctuation chars [_*~,;:.!?\\)\\]]\n var len = url.length;\n var suffix = '';\n for (var i = len - 1; i >= 0; --i) {\n var char = url.charAt(i);\n\n if (/[_*~,;:.!?]/.test(char)) {\n // it's a punctuation char\n // we remove it from the url\n url = url.slice(0, -1);\n // and prepend it to the suffix\n suffix = char + suffix;\n } else if (/\\)/.test(char)) {\n var opPar = url.match(/\\(/g) || [];\n var clPar = url.match(/\\)/g);\n\n // it's a curved parenthesis so we need to check for \"balance\" (kinda)\n if (opPar.length < clPar.length) {\n // there are more closing Parenthesis than opening so chop it!!!!!\n url = url.slice(0, -1);\n // and prepend it to the suffix\n suffix = char + suffix;\n } else {\n // it's (kinda) balanced so our work is done\n break;\n }\n } else if (/]/.test(char)) {\n var opPar2 = url.match(/\\[/g) || [];\n var clPar2 = url.match(/\\]/g);\n // it's a squared parenthesis so we need to check for \"balance\" (kinda)\n if (opPar2.length < clPar2.length) {\n // there are more closing Parenthesis than opening so chop it!!!!!\n url = url.slice(0, -1);\n // and prepend it to the suffix\n suffix = char + suffix;\n } else {\n // it's (kinda) balanced so our work is done\n break;\n }\n } else {\n // it's not a punctuation or a parenthesis so our work is done\n break;\n }\n }\n\n // we copy the treated url to the text variable\n var text = url;\n // finally, if it's a www shortcut, we prepend http\n url = (urlPrefix === 'www.') ? 'http://' + url : url;\n\n // url part is done so let's take care of text now\n // we need to escape the text (because of links such as www.example.com/foo__bar__baz)\n text = text.replace(showdown.helper.regexes.asteriskDashTildeAndColon, showdown.helper.escapeCharactersCallback);\n\n // finally we dispatch the event\n var evt = createEvent(urlRgx, evtRootName + '.captureStart', wholeMatch, text, null, url, null, options, globals);\n\n // and return the link tag, with the leadingMDChars and suffix. The leadingMDChars are added at the end too because\n // we consumed those characters in the regexp\n return leadingMDChars + writeAnchorTag(evt, options, globals) + suffix + leadingMDChars;\n });\n\n // 2. Then mails\n var mailRgx = /(^|\\s)(?:mailto:)?([A-Za-z0-9!#$%&'*+-/=?^_`{|}~.]+@[-a-z0-9]+(\\.[-a-z0-9]+)*\\.[a-z]+)(?=$|\\s)/gmi;\n text = text.replace(mailRgx, function (wholeMatch, leadingChar, mail) {\n var url = 'mailto:';\n mail = showdown.subParser('makehtml.unescapeSpecialChars')(mail, options, globals);\n if (options.encodeEmails) {\n url = showdown.helper.encodeEmailAddress(url + mail);\n mail = showdown.helper.encodeEmailAddress(mail);\n } else {\n url = url + mail;\n }\n var evt = createEvent(mailRgx, evtRootName + '.captureStart', wholeMatch, mail, null, url, null, options, globals);\n return leadingChar + writeAnchorTag(evt, options, globals);\n });\n\n\n text = globals.converter._dispatch(evtRootName + '.end', text, options, globals).getText();\n return text;\n });\n})();\n"
},
{
"path": "src/subParsers/makehtml/lists.js",
"content": "/**\n * Form HTML ordered (numbered) and unordered (bulleted) lists.\n */\nshowdown.subParser('makehtml.lists', function (text, options, globals) {\n 'use strict';\n\n /**\n * Process the contents of a single ordered or unordered list, splitting it\n * into individual list items.\n * @param {string} listStr\n * @param {boolean} trimTrailing\n * @returns {string}\n */\n function processListItems (listStr, trimTrailing) {\n // The $g_list_level global keeps track of when we're inside a list.\n // Each time we enter a list, we increment it; when we leave a list,\n // we decrement. If it's zero, we're not in a list anymore.\n //\n // We do this because when we're not inside a list, we want to treat\n // something like this:\n //\n // I recommend upgrading to version\n // 8. Oops, now this line is treated\n // as a sub-list.\n //\n // As a single paragraph, despite the fact that the second line starts\n // with a digit-period-space sequence.\n //\n // Whereas when we're inside a list (or sub-list), that line will be\n // treated as the start of a sub-list. What a kludge, huh? This is\n // an aspect of Markdown's syntax that's hard to parse perfectly\n // without resorting to mind-reading. Perhaps the solution is to\n // change the syntax rules such that sub-lists must start with a\n // starting cardinal number; e.g. \"1.\" or \"a.\".\n globals.gListLevel++;\n\n // trim trailing blank lines:\n listStr = listStr.replace(/\\n{2,}$/, '\\n');\n\n // attacklab: add sentinel to emulate \\z\n listStr += '¨0';\n\n var rgx = /(\\n)?(^ {0,3})([*+-]|\\d+[.])[ \\t]+((\\[([xX ])])?[ \\t]*[^\\r]+?(\\n{1,2}))(?=\\n*(¨0| {0,3}([*+-]|\\d+[.])[ \\t]+))/gm,\n isParagraphed = (/\\n[ \\t]*\\n(?!¨0)/.test(listStr));\n\n // Since version 1.5, nesting sublists requires 4 spaces (or 1 tab) indentation,\n // which is a syntax breaking change\n // activating this option reverts to old behavior\n // This will be removed in version 2.0\n if (options.disableForced4SpacesIndentedSublists) {\n rgx = /(\\n)?(^ {0,3})([*+-]|\\d+[.])[ \\t]+((\\[([xX ])])?[ \\t]*[^\\r]+?(\\n{1,2}))(?=\\n*(¨0|\\2([*+-]|\\d+[.])[ \\t]+))/gm;\n }\n\n listStr = listStr.replace(rgx, function (wholeMatch, m1, m2, m3, m4, taskbtn, checked) {\n checked = (checked && checked.trim() !== '');\n\n var item = showdown.subParser('makehtml.outdent')(m4, options, globals),\n bulletStyle = '';\n\n // Support for github tasklists\n if (taskbtn && options.tasklists) {\n\n // Style used for tasklist bullets\n bulletStyle = ' class=\"task-list-item';\n if (options.moreStyling) {bulletStyle += checked ? ' task-list-item-complete' : '';}\n bulletStyle += '\" style=\"list-style-type: none;\"';\n\n item = item.replace(/^[ \\t]*\\[([xX ])?]/m, function () {\n var otp = '- a
![\\\"moon\\\"](\\\"moon.jpg\\\")
![\\\"foo](\\\"train.jpg\\\" "\\\\"train")
![\\\"foo](\\\"/path/to/train.jpg\\\" "\\\\"title\\\\"")
![\"my](\"./pic/pic1_50.png\")
![\"inline](\"http://my.site.com/mona-lisa.png\")
![\"inline](\"http://images.com/mona-lisa.png\")
![\"global](\"https://www.my-photo-site.com/mona-lisa.png\")
![\"Showdown\"](\"https://raw.githubusercontent.com/showdownjs/logo/master/dist/logo.readme.png\"){kind=logo}
![\"img\"](\"foo.jpg\")
![\"Alt](\"http://www.addictedtoibiza.com/wp-content/uploads/2012/12/example.png\")
![\"sd-ref\"](\"https://www.google.pt/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png\")
![\"image\"](\"./image/cat(1).png\")
![\"image](\"./image/cat1).png\")
![\"the-image\"](\"http://example.com/foo.png\")
]![\"my](\"http://myserver.com/my_kitty.jpg\")
![\"image\"](\"./images(1)/cat(1).png\")
![\"my](\"images(1)/cat(1).png\")
![\"HTML5\"](\"http://www.w3.org/html/logo/img/mark-word-icon.png\" "\\"HTML5"){kind=icon}
![\"An](\"mypic.png\")
\n ![\"image](\"./image/cat1.png\")
(some text between brackets)![\"Alt](\"/path/to/img.jpg\")
![\"Alt](\"url/to/image.jpg\" "\\"Optional")
![\"My](\"url/to/image2.jpg\" "\\"Optional")
![http://website.com/img@x2.jpg](\"http://website.com/img@x2.jpg\"){kind=link}
![http://website.com/img-x2.jpg](\"http://website.com/img-x2.jpg\"){kind=link}
![http://website.com/img@.jpg](\"http://website.com/img@.jpg\"){kind=link}
![link](\"example.jpg\"){kind=link}