This plugin adds HTML definition lists to Obsidian. It is in the very early stages of development, and quite a bit more is planned.
It supports both reading view and live preview/source mode.
Special thanks to @lucible who, at this point, has contributed more to this project than I have. Thank you!
While definition lists are not part of the standard markdown definition, a number of varients have introduced it. This plugin has adopted the markup standard as described in the Extended Syntax. It also implements a few features from Pandoc's definition list spec, specifically the support for tilde as a definition marker and definition lines indented with two spaces.
First Term
: First definition.
Second Term
~ Second definition
~ Alternate second definition with _italics_ and [a link](https://example.com).
Third Term, with _Italics_ and ==Highlighting==
: Third definition, indented
Multiple definitions with line breaks between them are not fully supported. For example, the following is supported in Pandoc but will not render as 1 term with 2 definitions in reading mode. It does render in live preview, though.
This is an example term
: this is the first definition
: this is another definition.
- Multi-line terms
- Multi-line/paragraph definitions
- Definition lists nested inside definitions
- Ordered & unordered lists nested inside definitions
Because definition lists are not part of the standard Obsidian markup, they are not recognized by any of the available themes. This plugin adds a couple bits of simple styling, but you will likely have to use CSS Snippits to style to match your themes.
If you come up with some CSS that matches a popular theme please share it by creating a Github Issue on this project. I would like to build a collection of CSS samples others can use.
- Build a collection of sample CSS snippits
- Settings to account for common alternatives
- dt's and dd's inline vs separate lines
- Use eslint and improve code quality
Clone this repository inside the Obsidian Vault:
$ cd .obsidian/plugins/
$ git clone https://github.com/shammond42/definition-list
Resolve the plugin dependencies and build it:
$ cd definition-list
$ npm i
$ npm run build
Restart Obsidian and enable the plugin from Community Plugins in Settings.
If you wish to make changes to the plugin, run npm run dev
instead of npm run build.
Contributions are more than welome. If you wish to do so, please follow these instructions.
- Fork this repository and follow the steps from the previous section using the forked repository instead
- Create a feature branch for the changes
- Commit the changes and push them to the forked repository
- Submit a pull request