Deck: Markdown does not render

Created on 6 May 2020  ·  13Comments  ·  Source: nextcloud/deck

Describe the bug
Editing a ticket seems fine, but the rendering is not working, as it display all text in one line, with no unordered list not checboxes.

To Reproduce
Steps to reproduce the behavior:

  1. Edit a ticket, with markdown code, for example unordered lists and checkboxes
  2. Click the eye to render it

Expected behavior
The markdown code should be rendered

Screenshots

MD code editing:
Capture d’écran 2020-05-06 à 16 12 55

MD code rendering:
Capture d’écran 2020-05-06 à 16 13 07

Client details:

  • OS: macOS 10.14.6 Mojave
  • Browser: Chrome
  • Version: 81.0.4044.129
  • Device: MacBook Air (2013?)


Server details

Operating system:

Web server:
Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips (fpm-fcgi

Database:
mysql 5.5.56

PHP version:
7.2.17
Modules loaded: Core, date, libxml, openssl, pcre, zlib, filter, hash, Reflection, SPL, session, standard, cgi-fcgi, bcmath, bz2, calendar, ctype, curl, dom, mbstring, fileinfo, ftp, gd, gettext, iconv, intl, json, ldap, exif, mysqlnd, PDO, Phar, posix, shmop, SimpleXML, sockets, sqlite3, sysvmsg, sysvsem, sysvshm, tokenizer, xml, xmlwriter, xsl, mcrypt, mysqli, pdo_mysql, pdo_sqlite, wddx, xmlreader, apcu, gnupg, imagick, smbclient, zip, libsmbclient, Zend OPcache

Nextcloud version: (see Nextcloud admin page)
18.0.3 - 18.0.3.0

Where did you install Nextcloud from:

Signing status:

Login as admin user into your Nextcloud and access
http://example.com/index.php/settings/integrity/failed
paste the results here.

List of activated apps:

If you have access to your command line run e.g.:
sudo -u www-data php occ app:list
from within your Nextcloud installation folder

Nextcloud configuration:

If you have access to your command line run e.g.:
sudo -u www-data php occ config:list system
from within your Nextcloud installation folder

or

Insert your config.php content here
Make sure to remove all sensitive content such as passwords. (e.g. database password, passwordsalt, secret, smtp password, …)

Are you using an external user-backend, if yes which one: LDAP/ActiveDirectory/Webdav/...


Logs

Nextcloud log (data/nextcloud.log)

Insert your Nextcloud log here

Browser log

Insert your browser log here, this could for example include:

a) The javascript console log
b) The network log
c) ...

regression high

Most helpful comment

While we're talking about documentation, it states that it uses the markdown-it script for markdown support. Anything that works in the markdown-it live editor should also work in Deck.

Markdown comes in may flavors. The best way to learn markdown and understand how to use it, is simply to try it on the original script official playground.

Besides checkboxes, I'm having bullet lists and even headings fail to render when adding # in front of a line.

So if you copy the sample from the "try it" page into Deck you can see what's working and what's not. Links don't render as links, only as bold. Bullet points don't render. Emojis don't render. Only H2 and H3 headings render properly, but no other headings.

I think there's something besides a syntax issue going on here

image

All 13 comments

Got same behavior with Deck V1.0:

Client OS - Windows 10
Client browser - Firefox 76, Chrome 81.0.4044.129

Server configuration
Operating system: Ubuntu 18.04.1
Web server: Apache2
Database: PostgreSQL 10.10
PHP version: 7.2.24
Nextcloud version: 18.0.4

Confirmed with Firefox 75 and 76.

One little addition:
the checkmarks work when using '- [ ]' instead of '[ ]'

editing:
Screenshot from 2020-05-06 18-56-15

rendered:
Screenshot from 2020-05-06 18-56-34

It seems that this might be a CSS issue. As can be seen in the screenshot below, the HTML elements get inserted properly:
Screenshot

It seems that this might be a CSS issue.

I don't think it is an issue with the CSS alone as the checkboxes are output as plain text in the HTML output, unless you add the "-" bullets.

EDIT: Adding screenshots. The section H1 is in the HTML output as well but also shown as regular text in the description panel.

Description panel section:

Screen Shot 2020-05-07 at 12 59 27 PM

Rendered HTML for this section:

Screen Shot 2020-05-07 at 12 59 14 PM

EDIT 2: Links are also output as HTML but rendered as regular text in the panel.

The checkboxes are a different issue, however. There are a lot of different markdown dialects, and not every dialect supports checkboxes. Commonmarkdown, which is the dialect used according to the Deck docs, does not. So the fact that - [ ] works, is a non-standard extension of the parsing library.

Commonmarkdown, which is the dialect used according to the Deck docs, does not.

Slightly off topic: My thinking was that the markdown dialect supported by Deck accepted checkboxes, seeing as how they are used the generate the card's task list metric, ie. "✓ 2/8." If not, I suppose the checkboxes issue could be separate as it must be parsed internally.

In previous versions, Deck used to support checkboxes in the card and progress on the board/stack à la "✓ 2/8."
So, one can assume it is supposed to work, thus it is probably a bug.

The specific dialect used by Deck does indeed support checkboxes. But it seems like the syntax changed from just [ ] to - [ ]. Since this is not covered by the CommonMarkdown spec, different Markdown parsers can support different syntax. While this may be a breaking change, it is not a bug in the same way that most Markdown is not rendered properly. All I'm saying is: We have two separate issues here.

While we're talking about documentation, it states that it uses the markdown-it script for markdown support. Anything that works in the markdown-it live editor should also work in Deck.

Markdown comes in may flavors. The best way to learn markdown and understand how to use it, is simply to try it on the original script official playground.

Besides checkboxes, I'm having bullet lists and even headings fail to render when adding # in front of a line.

So if you copy the sample from the "try it" page into Deck you can see what's working and what's not. Links don't render as links, only as bold. Bullet points don't render. Emojis don't render. Only H2 and H3 headings render properly, but no other headings.

I think there's something besides a syntax issue going on here

image

I"m having the same issue.

I accidentally reported it in the Android Repo:
https://github.com/stefan-niedermann/nextcloud-deck/issues/474

I can confirm.

Deck: 1.0.0
NextCloud: 18.0.4
Kubuntu: 19.10

in edit mode:
https://hieronymusch.net/nextcloud/index.php/s/ToH5Fbs9yp235qg
in view mode:
https://hieronymusch.net/nextcloud/index.php/s/qj9oWfWCaFXQQxk

Love this Nextcloud App, i am sorry to have the same issue.
Got same behavior with Deck V1.0:

Client OS - Linux Mint 19.3
Client browser - Firefox 76.0

Web server: Apache
Nextcloud version: 18.0.3

Was this page helpful?
0 / 5 - 0 ratings

Related issues

RobertZenz picture RobertZenz  ·  4Comments

jbonlinea picture jbonlinea  ·  4Comments

PanCakeConnaisseur picture PanCakeConnaisseur  ·  4Comments

poVoq picture poVoq  ·  4Comments

ampoz picture ampoz  ·  4Comments