<div dir="ltr"><div>Hi all,</div><div><br></div><div>I'd like to propose that more markup be supported in app descriptions to allow publishers to express more.</div><div><br></div><div>The spec [1] currently supports the following:</div><div>- paragraphs <p><br></div><div>- ordered and unordered lists <ol>, <ul> and <li><br></div><div><br></div><div>I propose we add the following:</div><div>- emphasis <em></div><div>- strong emphasis <strong></div><div>- code <code> or <pre> or <pre><code> (CommonMark uses options 1 and 3, but it's probably simpler to just only <code> or <pre> in AppStream. I'm not enough of an XML expert to work out the differences between these tags).<br></div><div><br></div><div>I haven't picked these at random, as these are elements used in Markdown from the CommonMark spec [2]. I'm familiar with this because Snaps use a subset of CommonMark for their descriptions and I want to be able to translate these descriptions into an AppStream compatible format so they can be more easily shown in AppStream based apps like GNOME Software.</div><div><br></div><div>I do think these are generally useful tags to use for descriptions for any system. Markdown is used quite a lot now (see GitHub/GitLab, .md files etc) so the concepts of emphasis and code blocks are well understood and used features.</div><div><br></div><div>For completeness the other major features of Markdown are:</div><div>- headers</div><div>- links</div><div>- images</div><div>I'm not proposing we add those at this time as the headers can be confusing with the information shown around descriptions (it's a few paragraphs, not a complete document) and links and images can be used maliciously. We do support making links clickable in Snaps, but this is not something that needs to be explicitly tagged in the description data.<br></div><div><br></div><div>Thanks!<br></div><div>--Robert<br></div><div><br></div><div>[1] <a href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-description">https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-description</a></div><div>[2] <a href="https://commonmark.org/">https://commonmark.org/</a></div></div>