Bug 401022

Summary: okular markdown backend doesn't render lists correctly
Product: [Applications] okular Reporter: S. Christian Collins <s_chriscollins>
Component: generalAssignee: Okular developers <okular-devel>
Status: RESOLVED NOT A BUG    
Severity: normal CC: aacid
Priority: NOR    
Version: 1.5.3   
Target Milestone: ---   
Platform: Neon   
OS: Linux   
Latest Commit: Version Fixed In:
Attachments: markdown file that renders incorrectly
example of correct markdown rendering

Description S. Christian Collins 2018-11-14 04:56:47 UTC
Created attachment 116299 [details]
markdown file that renders incorrectly

Okular's markdown backend doesn't display lists correctly.

Steps to reproduce:
1. Open attached "test.md" file in Okular.

Result: The lists display all on a single line and the bullet character isn't used.

Expected result: The lists should display as lists with bullets instead of asterisks/hyphens.

SOFTWARE/OS VERSIONS
OS: KDE neon 5.14
KDE Plasma Version: 5.14.3
KDE Frameworks Version: 5.52.0
Qt Version: 5.11.2
Comment 1 S. Christian Collins 2018-11-14 04:59:58 UTC
Created attachment 116300 [details]
example of correct markdown rendering

For comparison, here is the attached test file rendered in Typora (https://typora.io/).
Comment 2 Albert Astals Cid 2018-11-14 19:32:54 UTC
I'm going to close this this as "NOT A BUG".

The problem with Markdown is that it's basically broken.

See https://goo.gl/sg9rXY for the 12 different ways the file you posted can be rendered by different markdown renderers, as far as i can see we render like other 8 implementations (seems to be item #1) so we are "relatively standard" as far as rendering markdown.
Comment 3 S. Christian Collins 2018-11-14 19:49:26 UTC
Seems like a bizarre way to render a list, and difficult to read. I'll file a feature request instead.
Comment 4 S. Christian Collins 2018-11-14 20:10:25 UTC
Okay, so I discovered that the list items display on individual lines with bullet glyphs if I add a blank line before the group of list items. I will presume this is the intended behavior and update my markdown files accordingly.