package org.jetbrains.dokka public open class MarkdownFormatService(locationService: LocationService, signatureGenerator: LanguageService) : StructuredFormatService(locationService, signatureGenerator) { override val extension: String = "md" override public fun formatBreadcrumbs(items: Iterable): String { return items.map { formatLink(it) }.joinToString(" / ") } override public fun formatText(text: String): String { return text.htmlEscape() } override fun formatSymbol(text: String): String { return text.htmlEscape() } override fun formatKeyword(text: String): String { return text.htmlEscape() } override fun formatIdentifier(text: String): String { return text.htmlEscape() } override public fun formatCode(code: String): String { return "`$code`" } override public fun formatList(text: String): String { return text } override fun formatListItem(text: String): String { return "* $text" } override public fun formatStrong(text: String): String { return "**$text**" } override fun formatEmphasis(text: String): String { return "*$text*" } override public fun formatLink(text: String, location: Location): String { return "[$text](${location.path})" } override fun formatLink(text: String, href: String): String { return "[$text]($href)" } override public fun appendLine(to: StringBuilder) { to.appendln() } override public fun appendLine(to: StringBuilder, text: String) { to.appendln(text) } override public fun appendParagraph(to: StringBuilder, text: String) { to.appendln() to.appendln(text) to.appendln() } override public fun appendHeader(to: StringBuilder, text: String, level: Int) { appendLine(to) appendLine(to, "${"#".repeat(level)} $text") appendLine(to) } override public fun appendBlockCode(to: StringBuilder, lines: Iterable) { appendLine(to) appendLine(to, "```") for (line in lines) to.appendln(line) appendLine(to, "```") appendLine(to) } override public fun appendBlockCode(to: StringBuilder, line: String) { appendLine(to) to.appendln("```") to.appendln(line) to.appendln("```") appendLine(to) } override fun appendTable(to: StringBuilder, body: () -> Unit) { to.appendln() body() to.appendln() } override fun appendTableHeader(to: StringBuilder, body: () -> Unit) { body() } override fun appendTableBody(to: StringBuilder, body: () -> Unit) { body() } override fun appendTableRow(to: StringBuilder, body: () -> Unit) { to.append("|") body() to.appendln() } override fun appendTableCell(to: StringBuilder, body: () -> Unit) { to.append(" ") body() to.append(" |") } var outlineLevel = 0 override fun appendOutlineHeader(to: StringBuilder, node: DocumentationNode) { val indent = " ".repeat(outlineLevel) appendLine(to, "$indent- title: ${languageService.renderName(node)}") appendLine(to, "$indent url: ${locationService.location(node).path}") } override fun appendOutlineChildren(to: StringBuilder, nodes: Iterable) { val indent = " ".repeat(outlineLevel) appendLine(to, "$indent content:") outlineLevel++ for (node in nodes) { appendOutlineHeader(to, node) if (node.members.any()) { appendOutlineChildren(to, node.members) } appendLine(to) } outlineLevel-- } }