- Be specific. Generic questions like "how to do plug-ins" and
- Be specific. Generic questions like "how to do plugins" and
"how to learn programming" are not accepted.
"how to learn programming" are not accepted.
- Don't ask us to break [CommonMark](http://commonmark.org/) specification.
- Don't ask us to break [CommonMark](http://commonmark.org/) specification.
Such things should be discussed first on [CommonMark forum](http://talk.commonmark.org/).
Such things should be discussed first on [CommonMark forum](http://talk.commonmark.org/).
@ -38,7 +38,7 @@ Before continuing, make sure you've read:
To simplify search:
To simplify search:
- add to `package.json` keyswords `markdown-it` and `markdown-it-plugin` for plug-ins.
- add to `package.json` keyswords `markdown-it` and `markdown-it-plugin` for plugins.
- add keyword `markdown-it` for any other related packages.
- add keyword `markdown-it` for any other related packages.
@ -69,9 +69,9 @@ See implementations of [linkify](https://github.com/markdown-it/markdown-it/blob
__Note.__ Don't try to replace text with HTML markup! That's not secure.
__Note.__ Don't try to replace text with HTML markup! That's not secure.
#### Why my in-line rule is not executed?
#### Why my inline rule is not executed?
The in-line parser skips pieces of texts to optimize speed. It stops only on [a small set of chars](https://github.com/markdown-it/markdown-it/blob/master/lib/rules_inline/text.js), which can be tokens. We did not made this list extensible for performance reasons too.
The inline parser skips pieces of texts to optimize speed. It stops only on [a small set of chars](https://github.com/markdown-it/markdown-it/blob/master/lib/rules_inline/text.js), which can be tokens. We did not made this list extensible for performance reasons too.
If you are absolutely sure that something important is missing there - create a
If you are absolutely sure that something important is missing there - create a
ticket and we will consider adding it as a new charcode.
ticket and we will consider adding it as a new charcode.
@ -80,7 +80,7 @@ ticket and we will consider adding it as a new charcode.
#### Why do you reject some useful things?
#### Why do you reject some useful things?
We do a markdown parser. It should keep the "markdown spirit". Other things should
We do a markdown parser. It should keep the "markdown spirit". Other things should
be kept separate, in plug-ins, for example. We have no clear criteria, sorry.
be kept separate, in plugins, for example. We have no clear criteria, sorry.
Probably, you will find [CommonMark forum](http://talk.commonmark.org/) a useful read to understand us better.
Probably, you will find [CommonMark forum](http://talk.commonmark.org/) a useful read to understand us better.
Of course, if you find the architecture of this parser interesting for another type
Of course, if you find the architecture of this parser interesting for another type