\
**Category:** IntelliJ Platform\
**Created:** [August 5, 2025, 4:06pm UTC](https://platform.jetbrains.com/t/change-notes-need-to-be-html-for-proper-display-in-settings-plugins-window/2446 "2025-08-05T16:06:19Z")\
**Posts on this page:** 3\
**Page:** 1
**Author:**  [@helinx](https://platform.jetbrains.com/u/helinx)\
**Post date:** [August 5, 2025, 4:06pm UTC](https://platform.jetbrains.com/t/change-notes-need-to-be-html-for-proper-display-in-settings-plugins-window/2446/1 "2025-08-05T16:06:19Z")
Change notes are often stored in a separate file instead of being updated in the plugin.xml file directly. We have a CHANGELOG.md and used a file provider to add these notes to the plugin.xml during build. However, we noticed that while the notes in md format show up fine on the web site (e.g. [https://plugins.jetbrains.com/plugin/9212-flutter/edit/versions/stable/818757](https://plugins.jetbrains.com/plugin/9212-flutter/edit/versions/stable/818757)), the formatting is gone in the Settings window in IntelliJ.
We fixed this problem by converting our CHANGELOG.md to use HTML formatting in our build.gradle file, but it seems like the Settings window should handle doing this type of conversion instead, since I imagine many projects use a MD format changelog. Is there a neater way around this than adding custom code to convert MD to HTML?
Some documentation I consulted while working on this:
> **[Best practices for listing your plugin | JetBrains Marketplace](https://plugins.jetbrains.com/docs/marketplace/best-practices-for-listing.html#change-notes)**
> **[Plugin Configuration File | IntelliJ Platform Plugin SDK](https://plugins.jetbrains.com/docs/intellij/plugin-configuration-file.html#idea-plugin__change-notes)**
---
**Author:**  [@jonathanlermitage.1](https://platform.jetbrains.com/u/jonathanlermitage.1)\
**Post date:** [August 5, 2025, 9:07pm UTC](https://platform.jetbrains.com/t/change-notes-need-to-be-html-for-proper-display-in-settings-plugins-window/2446/2 "2025-08-05T21:07:07Z")
Look at the intellij plugin template. Both plugin description and changelog are in markdown, and they’re converted to HTML during the build: [intellij-platform-plugin-template/build.gradle.kts at main · JetBrains/intellij-platform-plugin-template · GitHub](https://github.com/JetBrains/intellij-platform-plugin-template/blob/main/build.gradle.kts)
---
**Author:**  [@helinx](https://platform.jetbrains.com/u/helinx)\
**Post date:** [August 6, 2025, 10:11pm UTC](https://platform.jetbrains.com/t/change-notes-need-to-be-html-for-proper-display-in-settings-plugins-window/2446/3 "2025-08-06T22:11:35Z")
Thanks! I didn’t think to just look more carefully at the template.