How to parse Jira Wiki Syntax?

vsch / flexmark-java

CommonMark/Markdown Java parser with source level AST. CommonMark 0.28, emulation of: pegdown, kramdown, markdown.pl, MultiMarkdown. With HTML to MD, MD to PDF, MD to DOCX conversion modules.

BSD 2-Clause "Simplified" License

2.25k stars 264 forks source link

How to parse Jira Wiki Syntax? #506

Open jpwilhelms opened 2 years ago

jpwilhelms commented 2 years ago

I have to convert the Jira Wiki Syntax (https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all) into Microsoft word elements. My idea was to use flexmark-java with the docx renderer extension. Is there already a parser for the Jira Syntax?

jpw-src commented 2 years ago

For parsing a header line "h1. my heading" I tried different ways:

Parser.builder().customBlockParserFactory()
Parser.builder().paragraphPreProcessorFactory()
Parser.builder().blockPreProcessorFactory()

In each registered factory I identified the "h1." substring, extracted the header text and inserted a Header-Node. When rendering the result as HTML I always get an empty <h1></h1> section.

Could someone please show me the recommended way to convert this "h1. xxxxx" to AST nodes?