[ 
https://issues.apache.org/jira/browse/DOXIA-770?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Konrad Windszus updated DOXIA-770:
----------------------------------
    Description: 
Currently all characters which can be escaped in markdown are escaped. This 
should be improved so that characters are only escaped when necessary. This 
requires evaluation of the context. Compare with 
https://github.com/jgm/pandoc/issues/6259.


||Character||Escaping condition||
|backslash|Always|
|`|When otherwise may be interpreted as inline code|
|curly braces|Never(?)|
|square brackets|When otherwise may be interpreted as link, reference, footnote 
or image|
|paretheses|When otherwise may be interpreted as inline link or image|
|hash|When otherwise may be interpreted as header (those can be used at the 
beginning or end of line)|
|*|Inside unordered lists or when otherwise be misinterpreted as horizontal 
rule|
|+|Inside unordered lists|
|-|Inside unordered lists or when otherwise be misinterpreted as horizontal 
rule|
|.|Inside ordered lists|
|!|When otherwise be interpreted as image|


  was:
Currently all characters which can be escaped in markdown are escaped. This 
should be improved so that characters are only escaped when necessary. This 
requires evaluation of the context. Compare with 
https://github.com/jgm/pandoc/issues/6259.


||Character||Escaping condition||
|backslash|Always|
|`||
|curly braces|Never(?)|
|square brackets|When otherwise may be interpreted as link, reference, footnote|
|paretheses|When otherwise may be interpreted as inline link|
|hash||
|*|Inside unordered lists|
|+|Inside unordered lists|
|-|Inside unordered lists|
|.|Inside ordered lists|
|!||



> MarkdownSink: Only escape when necessary 
> -----------------------------------------
>
>                 Key: DOXIA-770
>                 URL: https://issues.apache.org/jira/browse/DOXIA-770
>             Project: Maven Doxia
>          Issue Type: Improvement
>            Reporter: Konrad Windszus
>            Assignee: Konrad Windszus
>            Priority: Major
>
> Currently all characters which can be escaped in markdown are escaped. This 
> should be improved so that characters are only escaped when necessary. This 
> requires evaluation of the context. Compare with 
> https://github.com/jgm/pandoc/issues/6259.
> ||Character||Escaping condition||
> |backslash|Always|
> |`|When otherwise may be interpreted as inline code|
> |curly braces|Never(?)|
> |square brackets|When otherwise may be interpreted as link, reference, 
> footnote or image|
> |paretheses|When otherwise may be interpreted as inline link or image|
> |hash|When otherwise may be interpreted as header (those can be used at the 
> beginning or end of line)|
> |*|Inside unordered lists or when otherwise be misinterpreted as horizontal 
> rule|
> |+|Inside unordered lists|
> |-|Inside unordered lists or when otherwise be misinterpreted as horizontal 
> rule|
> |.|Inside ordered lists|
> |!|When otherwise be interpreted as image|



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

Reply via email to