Markdown blockquotes does not render properly in dark mode

[jhdcruz]

Describe the bug

Blockquotes does not render properly in dark mode when adding markdown using dokka-base plugin.

Expected behaviour

• Switches/renders dark mode theme properly;
• Readable blockquotes in dark mode.

Screenshots

Light mode	Dark Mode

To Reproduce

1. Add dokka-base plugin to any project that uses dokka
2. Add markdown with blockquotes using includes. (ex. README.md)
3. Generate documentation

Dokka configuration
Configuration of dokka used to reproduce the bug

tasks {
    dokkaHtmlMultiModule {
        ...

        pluginConfiguration<DokkaBase, DokkaBaseConfiguration> {
            includes.from(
                files(
                    "README.md"
                )
            )
            ...
        }
    }
}

Installation

• Operating system: Not applicable
• Build tool: Gradle v8.1.1
• Dokka version: 1.8.20

[IgnatBeresnev]

JFYI: it seems to have been partially fixed in #2836, and the fix will be released in the upcoming Dokka 1.9.0. Not sure how visible the left side panel should be though.

[solonovamax]

If you would like a 3rd party fix for this, consider trying out my dokka plugin, dokka style tweaks:

dependencies {
    dokkaPlugin("ca.solo-studios:dokka-style-tweaks-plugin:1.1.0")
}

it can then be configured using the type-safe plugin configuration:

 tasks {
     withType<AbstractDokkaTask>().configureEach {
         pluginConfiguration<DokkaStyleTweaksPlugin, DokkaStyleTweaksConfiguration> {
             minimalScrollbar = true
             darkPurpleHighlight = true
             improvedBlockquoteBorder = true
             lighterBlockquoteText = true
             sectionTabFontWeight = "500"
             sectionTabTransition = true
             improvedSectionTabBorder = true
             disableCodeWrapping = true
         }
     }
 }

or using json plugin configuration:

 tasks {
     withType<AbstractDokkaTask>().configureEach {
         val dokkaTweaksConfiguration = """
             {
                 "minimalScrollbar": true,
                 "darkPurpleHighlight": true,
                 "improvedBlockquoteBorder": true,
                 "lighterBlockquoteText": true,
                 "sectionTabFontWeight": "500"
                 "sectionTabTransition": true,
                 "improvedSectionTabBorder": true,
                 "disableCodeWrapping": true
             }
         """.trimIndent()
 
         pluginConfiguration.set(
                 mapOf(
                         "ca.solostudios.dokkastyles.plugin.DokkaStyleTweaksPlugin" to dokkaTweaksConfiguration,
                      )
                                )
     }
 }

all the tweaks are documented via kdoc, however you can find the source for it here

for this specific issue, the fix I applied can be used by setting lighterBlockquoteText to true. Also, if you don't like the weird blocky border for blockquotes, that can be changed for one that is (in my opinion) more appealing by setting improvedBlockquoteBorder to true, which instead uses a smaller purple-coloured bar, and is rounded on the corners.

note: by default, the plugin will apply no changes to the generated docs and will be identical to the docs without it. Everything is explicitly opt-in.