#1

Please add support for Definition Lists. Looks like there’s a Markdown-it parser plugin available, markdown-it-deflist. Example:

Term 1

:   Definition 1

Term 2 with *inline markup*

:   Definition 2

        { some code, part of Definition 2 }

    Third paragraph of definition 2.
63 Likes
Support for Markdown Definition Lists
Meta: how to implement a markdown plugin?
Markdown variable substitution
Definition lists
#2

I would love to see this feature added! It shouldn’t be very hard to do.

1 Like
#3

A definition list would help to structure information in a standardized QA style. I often use lists with indentation to do this now:

  • How does it work?
    • It works like this

A definition list would be much better.

3 Likes
#4

How is markdown support in different flavours?

From a Stackexchange thread (x = yes, - = no):

  • [x] Maruku
  • [x] kramdown
  • [x]MultiMarkdown
  • [x] Pandoc
  • [-] Github
  • [-] Gitlab
#5

Also see

1 Like
#6

Is it possible to add support for these lists, similar to https://www.markdownguide.org/extended-syntax/#definition-lists

First Term
: This is the definition of the first term.

Second Term
: This is one definition of the second term.
: This is another definition of the second term.

Thanks!

4 Likes
#7

in my books i use often the definition lists, should be really nice to have them rendered somehow here, yes

2 Likes
#8

I would like see support for definition lists, too.

2 Likes
#9

I’d like to have this supported as well, I’d use it a lot

2 Likes
#10

As a workaround you can embed HTML directly into the Markdown.

This works and renders correctly in the middle of a Markdown note in Obsidian:

<dl>
	<dt>term 1</dt>
	<dd>definition 1</dd>
	<dt>term 2</dt>
	<dd>definition 2</dd>
</dl>
4 Likes
#11

Yes, this does work in the meantime.

However, I hope you add the true markdown version, since it’s easier to write (as all markdown syntax) and looks cleaner in edit mode.

But thank you very much for the suggestion, I’ll be sure to use it while the markdown version is not available!

2 Likes
#12

I also support this notion

#13

To expand upon @maartin 's list, here is a list of many of the common implementations to have extended Markdown to include Definition Lists, with a link to their docs

System Support link to documentation
Pandoc YES Pandoc - Pandoc User’s Guide
Wordpress YES Markdown Quick Reference Cheat Sheet – Support — WordPress.com
Python-Markdown YES Definition Lists — Python-Markdown 3.3.4 documentation
php Markdown Extra YES PHP Markdown Extra
MultiMarkdown YES Definition Lists
SGML Markdown YES Markdown Definition List Examples
Maruku YES
kramdown YES
Markdown-it YES GitHub - markdown-it/markdown-it-deflist: Definition list (<dl>) tag plugin for markdown-it markdown parser
Gitlab On roadmap GitLab Content Editor | Strategy (&5401) · Epics · GitLab.org · GitLab
CommonMark No Description List - Extensions - CommonMark Discussion
Github No

Even though W3C decided to change their name to Term-Description Groups in HTML5, Definition Lists are a commonly used extension. The discussion on CommonMark above has been looking at implementing this since 2014, and they are only holding back in case some implementations find the ‘back-tracking’ hard to implement. GitLab are looking at it already, and once CommonMark adopts it the people like Github who follow CommonMark will do the same, so it’s only a matter of time.

It would be great to add Obsidian to the list of software that supports it - is the feature already available in any of the parsing libraries Obsidian uses?

5 Likes
#14

+1

I would find definitions useful too.

1 Like
#15

Also here for this! +1

1 Like
#16

Even though this feature request is a year old already, I still hope it will be implemented at some point too!

3 Likes
#17

It’s important for typing experience.

1 Like
#18

+1

This is needed for FAQs, all kinds of technical documentation, etc. At least 10% of all documents I write will have a need for it, sooner or later.

2 Likes
#19

I use definition lists a lot and it would be really nice to see them supported here. Thanks!

2 Likes
#20

Adding my vote for this too!

1 Like