diff --git a/frontend/src/components/css/chat-hljs-dark.less b/frontend/src/components/css/chat-hljs-dark.less
new file mode 100644
index 00000000..2137fa2b
--- /dev/null
+++ b/frontend/src/components/css/chat-hljs-dark.less
@@ -0,0 +1,75 @@
+// Dark-theme highlight token colors only. Chat Markdown layout/chrome styles
+// belong to chat-markdown.less.
+html[theme-mode='dark'] {
+ .markdown-content .chat-code-block__pre,
+ .answer-content .chat-code-block__pre,
+ .ai-markdown-template .chat-code-block__pre,
+ .agent-stream-display .chat-code-block__pre {
+ .hljs {
+ color: #c9d1d9;
+ }
+
+ .hljs-doctag,
+ .hljs-keyword,
+ .hljs-meta .hljs-keyword,
+ .hljs-template-tag,
+ .hljs-template-variable,
+ .hljs-type,
+ .hljs-variable.language_ {
+ color: #ff7b72;
+ }
+
+ .hljs-title,
+ .hljs-title.class_,
+ .hljs-title.class_.inherited__,
+ .hljs-title.function_ {
+ color: #d2a8ff;
+ }
+
+ .hljs-attr,
+ .hljs-attribute,
+ .hljs-literal,
+ .hljs-meta,
+ .hljs-number,
+ .hljs-operator,
+ .hljs-variable,
+ .hljs-selector-attr,
+ .hljs-selector-class,
+ .hljs-selector-id {
+ color: #79c0ff;
+ }
+
+ .hljs-regexp,
+ .hljs-string,
+ .hljs-meta .hljs-string {
+ color: #a5d6ff;
+ }
+
+ .hljs-built_in,
+ .hljs-symbol {
+ color: #ffa657;
+ }
+
+ .hljs-comment,
+ .hljs-code,
+ .hljs-formula {
+ color: #8b949e;
+ }
+
+ .hljs-name,
+ .hljs-quote,
+ .hljs-selector-tag,
+ .hljs-selector-pseudo {
+ color: #7ee787;
+ }
+
+ .hljs-subst {
+ color: #c9d1d9;
+ }
+
+ .hljs-section {
+ color: #1f6feb;
+ font-weight: 700;
+ }
+ }
+}
diff --git a/frontend/src/components/css/chat-hljs.less b/frontend/src/components/css/chat-hljs.less
new file mode 100644
index 00000000..6e767274
--- /dev/null
+++ b/frontend/src/components/css/chat-hljs.less
@@ -0,0 +1,72 @@
+// Syntax highlighting tokens for chat code blocks.
+.chat-markdown-hljs() {
+ :deep(.chat-code-block__pre) {
+ .hljs {
+ color: #24292e;
+ background: transparent;
+ }
+
+ .hljs-doctag,
+ .hljs-keyword,
+ .hljs-meta .hljs-keyword,
+ .hljs-template-tag,
+ .hljs-template-variable,
+ .hljs-type,
+ .hljs-variable.language_ {
+ color: #d73a49;
+ }
+
+ .hljs-title,
+ .hljs-title.class_,
+ .hljs-title.class_.inherited__,
+ .hljs-title.function_ {
+ color: #6f42c1;
+ }
+
+ .hljs-attr,
+ .hljs-attribute,
+ .hljs-literal,
+ .hljs-meta,
+ .hljs-number,
+ .hljs-operator,
+ .hljs-variable,
+ .hljs-selector-attr,
+ .hljs-selector-class,
+ .hljs-selector-id {
+ color: #005cc5;
+ }
+
+ .hljs-regexp,
+ .hljs-string,
+ .hljs-meta .hljs-string {
+ color: #032f62;
+ }
+
+ .hljs-built_in,
+ .hljs-symbol {
+ color: #e36209;
+ }
+
+ .hljs-comment,
+ .hljs-code,
+ .hljs-formula {
+ color: #6a737d;
+ }
+
+ .hljs-name,
+ .hljs-quote,
+ .hljs-selector-tag,
+ .hljs-selector-pseudo {
+ color: #22863a;
+ }
+
+ .hljs-subst {
+ color: #24292e;
+ }
+
+ .hljs-section {
+ color: #005cc5;
+ font-weight: 700;
+ }
+ }
+}
diff --git a/frontend/src/components/css/chat-markdown.less b/frontend/src/components/css/chat-markdown.less
new file mode 100644
index 00000000..20843e0a
--- /dev/null
+++ b/frontend/src/components/css/chat-markdown.less
@@ -0,0 +1,587 @@
+@import './chat-hljs.less';
+
+// Single source of truth for chat answer Markdown typography and block styles.
+// Used by botmsg, AgentStreamDisplay, embed chat, and the dev Markdown test page.
+// Future chat Markdown visual changes should be made here instead of in
+// individual Vue components. Non-chat document/wiki preview styles intentionally
+// live outside this file.
+//
+// Shared typography for chat answer markdown (botmsg, AgentStreamDisplay, embed).
+// Tuned against ChatGPT markdown test doc: 16px body, 24px line-height on paragraphs,
+// stepped headings, dotted links, light tables, pill inline code, kbd chips.
+.chat-markdown-typography() {
+ font-size: 16px;
+ color: var(--td-text-color-primary);
+ line-height: 1.625;
+ letter-spacing: normal;
+ -webkit-font-smoothing: antialiased;
+
+ :deep(p) {
+ margin: 0 0 0.25em;
+ line-height: 1.625;
+
+ + p {
+ margin-top: 0.75em;
+ }
+
+ &:last-child {
+ margin-bottom: 0;
+ }
+ }
+
+ // Citation-only paragraphs from marked (tag on its own line) — keep compact.
+ :deep(p:has(> .citation:only-child)) {
+ margin: 0.125em 0 0.375em;
+ line-height: 1.625;
+ }
+
+ // Inline citations share the paragraph line box with body text.
+ :deep(p:has(.citation)) {
+ line-height: 1.625;
+ }
+
+ :deep(p:has(.citation) + p:has(> img:only-child)),
+ :deep(p:has(> .citation:only-child) + p:has(> img:only-child)) {
+ margin-top: 0.5em;
+ }
+
+ // Models often emit standalone **小节标题:** paragraphs instead of headings.
+ :deep(p:has(> strong:only-child)) {
+ margin-top: 1.25em;
+ margin-bottom: 0.5em;
+ line-height: 1.5;
+
+ &:first-child {
+ margin-top: 0;
+ }
+ }
+
+ :deep(p + ul),
+ :deep(p + ol),
+ :deep(ul + p),
+ :deep(ol + p),
+ :deep(blockquote + p),
+ :deep(p + blockquote) {
+ margin-top: 0.75em;
+ }
+
+ :deep(strong) {
+ font-weight: 600;
+ }
+
+ :deep(em) {
+ font-style: italic;
+ }
+
+ :deep(del) {
+ text-decoration: line-through;
+ opacity: 0.72;
+ }
+
+ :deep(kbd) {
+ display: inline-block;
+ padding: 0.15em 0.45em;
+ font-family: var(--app-font-family-mono);
+ font-size: 0.8125em;
+ font-weight: 500;
+ line-height: 1.4;
+ color: var(--td-text-color-primary);
+ background: var(--td-bg-color-secondarycontainer);
+ border: 1px solid var(--td-component-stroke);
+ border-radius: 5px;
+ box-shadow: 0 1px 0 color-mix(in srgb, var(--td-text-color-primary) 8%, transparent);
+ }
+
+ :deep(code):not(pre code) {
+ background: color-mix(in srgb, var(--td-text-color-primary) 8%, transparent);
+ padding: 0.15em 0.3em;
+ border-radius: 4px;
+ font-family: var(--app-font-family-mono);
+ font-size: 0.875em;
+ font-weight: 500;
+ }
+
+ :deep(pre:not(.chat-code-block__pre):not(.chat-mermaid-block__canvas)) {
+ background: var(--td-bg-color-secondarycontainer);
+ padding: 14px 16px;
+ border: 1px solid var(--td-component-stroke);
+ border-radius: 8px;
+ overflow-x: auto;
+ margin: 0.75em 0;
+ line-height: 1.55;
+ font-size: 13px;
+
+ code {
+ background: none;
+ padding: 0;
+ font-size: inherit;
+ font-weight: 400;
+ }
+ }
+
+ :deep(.chat-code-block) {
+ margin: 0.75em 0;
+ border: 1px solid var(--td-component-stroke);
+ border-radius: 8px;
+ overflow: hidden;
+ background: var(--td-bg-color-container);
+ box-shadow: 0 1px 2px color-mix(in srgb, var(--td-text-color-primary) 6%, transparent);
+ }
+
+ :deep(.chat-code-block__header) {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 12px;
+ min-height: 36px;
+ padding: 6px 10px 6px 12px;
+ background: var(--td-bg-color-secondarycontainer);
+ border-bottom: 1px solid var(--td-component-stroke);
+ }
+
+ :deep(.chat-code-block__lang) {
+ font-size: 12px;
+ font-weight: 600;
+ line-height: 1.2;
+ color: var(--td-text-color-secondary);
+ letter-spacing: 0.02em;
+ text-transform: none;
+ }
+
+ :deep(.chat-code-block__copy) {
+ display: inline-flex;
+ align-items: center;
+ gap: 6px;
+ margin: 0;
+ padding: 4px 8px;
+ border: 1px solid transparent;
+ border-radius: 6px;
+ background: transparent;
+ color: var(--td-text-color-secondary);
+ font-size: 12px;
+ font-weight: 500;
+ line-height: 1;
+ cursor: pointer;
+ transition: background 0.15s ease, color 0.15s ease, border-color 0.15s ease;
+
+ &:hover {
+ background: color-mix(in srgb, var(--td-text-color-primary) 6%, var(--td-bg-color-secondarycontainer));
+ border-color: var(--td-component-border);
+ color: var(--td-text-color-primary);
+ }
+
+ &.is-copied {
+ color: var(--td-text-color-primary);
+ }
+
+ &.is-error {
+ color: var(--td-error-color);
+ }
+ }
+
+ :deep(.chat-code-block__copy-icon) {
+ flex-shrink: 0;
+ }
+
+ :deep(.chat-code-block__pre) {
+ margin: 0;
+ padding: 14px 16px;
+ border-radius: 0;
+ background: color-mix(in srgb, var(--td-bg-color-secondarycontainer) 88%, var(--td-bg-color-container));
+ overflow-x: auto;
+ font-size: 13px;
+ line-height: 1.55;
+
+ code {
+ background: transparent;
+ padding: 0;
+ border-radius: 0;
+ font-size: inherit;
+ font-weight: 400;
+ white-space: pre;
+ display: block;
+ }
+ }
+
+ :deep(.chat-mermaid-block) {
+ margin: 0.75em 0;
+ border: 1px solid var(--td-component-stroke);
+ border-radius: 10px;
+ overflow: hidden;
+ background: var(--td-bg-color-container);
+ box-shadow: 0 1px 3px color-mix(in srgb, var(--td-text-color-primary) 5%, transparent);
+ }
+
+ :deep(.chat-mermaid-block__header) {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 8px;
+ min-height: 36px;
+ padding: 6px 10px 6px 12px;
+ background: var(--td-bg-color-secondarycontainer);
+ border-bottom: 1px solid var(--td-component-stroke);
+ }
+
+ :deep(.chat-mermaid-block__badge) {
+ display: inline-flex;
+ align-items: center;
+ gap: 6px;
+ font-size: 12px;
+ font-weight: 600;
+ letter-spacing: 0.04em;
+ text-transform: uppercase;
+ color: var(--td-text-color-secondary);
+ }
+
+ :deep(.chat-mermaid-block__expand) {
+ display: inline-flex;
+ align-items: center;
+ justify-content: center;
+ width: 28px;
+ height: 28px;
+ margin: 0;
+ padding: 0;
+ border: 1px solid transparent;
+ border-radius: 6px;
+ background: transparent;
+ color: var(--td-text-color-secondary);
+ cursor: pointer;
+ transition: background 0.15s ease, color 0.15s ease, border-color 0.15s ease;
+
+ &:hover:not(:disabled) {
+ background: color-mix(in srgb, var(--td-text-color-primary) 6%, var(--td-bg-color-secondarycontainer));
+ border-color: var(--td-component-border);
+ color: var(--td-text-color-primary);
+ }
+
+ &:disabled,
+ &.is-disabled {
+ opacity: 0.35;
+ cursor: not-allowed;
+ }
+ }
+
+ :deep(.chat-mermaid-block__canvas) {
+ margin: 0;
+ padding: 20px 16px 18px;
+ border: 0;
+ border-radius: 0;
+ background: var(--td-bg-color-container);
+ overflow-x: auto;
+ text-align: center;
+ cursor: zoom-in;
+
+ svg {
+ max-width: 100%;
+ height: auto;
+ }
+
+ .node rect,
+ .node circle,
+ .node ellipse,
+ .node polygon,
+ .node path {
+ stroke-width: 1.5px;
+ }
+
+ .edgePath path,
+ .flowchart-link {
+ stroke-width: 1.6px;
+ }
+
+ .label,
+ .nodeLabel,
+ .edgeLabel {
+ font-family: var(--app-font-family);
+ }
+ }
+
+ :deep(.chat-mermaid-block--loading .streaming-mermaid-loading) {
+ margin: 0;
+ max-width: none;
+ min-height: 200px;
+ border: 0;
+ border-radius: 0;
+ }
+
+ :deep(pre.mermaid:not(.chat-mermaid-block__canvas)) {
+ margin: 0.75em 0;
+ padding: 20px 16px;
+ border: 1px solid var(--td-component-stroke);
+ border-radius: 10px;
+ background: var(--td-bg-color-secondarycontainer);
+ overflow-x: auto;
+ text-align: center;
+ cursor: zoom-in;
+
+ svg {
+ max-width: 100%;
+ height: auto;
+ }
+ }
+
+ :deep(ul) {
+ margin: 0.35em 0 0.75em;
+ padding-left: 1.625em;
+ list-style-type: disc;
+ list-style-position: outside;
+
+ ul {
+ list-style-type: disc;
+ margin: 0.25em 0 0;
+ padding-left: 1.25em;
+ }
+ }
+
+ :deep(ol) {
+ margin: 0.35em 0 0.75em;
+ padding-left: 1.625em;
+ list-style-type: decimal;
+ list-style-position: outside;
+
+ ol {
+ list-style-type: decimal;
+ margin: 0.25em 0 0;
+ padding-left: 1.25em;
+ }
+ }
+
+ :deep(li) {
+ margin: 0;
+ line-height: 1.625;
+ padding-left: 0.375em;
+
+ + li {
+ margin-top: 0.375em;
+ }
+
+ &::marker {
+ font-weight: 700;
+ color: var(--td-text-color-primary);
+ }
+
+ > p {
+ margin: 0;
+
+ + p {
+ margin-top: 0.25em;
+ }
+ }
+ }
+
+ :deep(ol > li)::marker {
+ font-variant-numeric: tabular-nums;
+ }
+
+ :deep(li > ul),
+ :deep(li > ol) {
+ margin-top: 0.25em;
+ margin-bottom: 0;
+ }
+
+ :deep(li:has(> input[type='checkbox'])) {
+ list-style: none;
+ margin-left: -1.625em;
+ padding-left: 0;
+
+ &::marker {
+ content: none;
+ }
+
+ input[type='checkbox'] {
+ margin: 0 0.5em 0 0;
+ vertical-align: middle;
+ accent-color: var(--td-brand-color);
+ }
+ }
+
+ :deep(blockquote) {
+ border-left: 2px solid var(--td-component-stroke);
+ padding: 0.5em 0 0.5em 1.25em;
+ margin: 0.5em 0 0.75em;
+ color: var(--td-text-color-secondary);
+ font-weight: 400;
+ font-style: normal;
+
+ blockquote {
+ margin-top: 0.35em;
+ margin-bottom: 0;
+ }
+ }
+
+ :deep(blockquote),
+ :deep(blockquote p) {
+ line-height: 1.5;
+ }
+
+ :deep(hr) {
+ margin: 1.75em 0;
+ border: none;
+ border-top: 1px solid var(--td-component-stroke);
+ }
+
+ :deep(h1) {
+ font-size: 1.5em;
+ font-weight: 600;
+ margin: 0 0 0.375em;
+ line-height: 1.333;
+ }
+
+ :deep(h2) {
+ font-size: 1.25em;
+ font-weight: 600;
+ margin: 1em 0 0.25em;
+ line-height: 1.4;
+
+ &:first-child {
+ margin-top: 0;
+ }
+ }
+
+ :deep(h3) {
+ font-size: 1.125em;
+ font-weight: 600;
+ margin: 0.875em 0 0.25em;
+ line-height: 1.556;
+ }
+
+ :deep(h4),
+ :deep(h5),
+ :deep(h6) {
+ font-weight: 600;
+ margin: 1em 0 0;
+ line-height: 1.5;
+ }
+
+ :deep(h4) {
+ font-size: 1em;
+ }
+
+ :deep(h5) {
+ font-size: 0.9375em;
+ }
+
+ :deep(h6) {
+ font-size: 0.875em;
+ font-weight: 600;
+ color: var(--td-text-color-secondary);
+ }
+
+ :deep(h1:first-child),
+ :deep(h2:first-child),
+ :deep(h3:first-child),
+ :deep(h4:first-child),
+ :deep(h5:first-child),
+ :deep(h6:first-child) {
+ margin-top: 0;
+ }
+
+ :deep(a) {
+ color: var(--td-brand-color);
+ text-decoration: underline;
+ text-decoration-color: color-mix(in srgb, var(--td-brand-color) 45%, transparent);
+ text-underline-offset: 0.18em;
+
+ &:hover {
+ color: var(--td-brand-color-hover);
+ text-decoration-color: var(--td-brand-color);
+ }
+ }
+
+ :deep(.chat-markdown-table) {
+ width: fit-content;
+ max-width: 100%;
+ margin: 0.875em 0 1em;
+ overflow-x: auto;
+ border: 1px solid var(--td-component-stroke);
+ border-radius: 8px;
+ background: var(--td-bg-color-container);
+ -webkit-overflow-scrolling: touch;
+ }
+
+ :deep(table) {
+ word-break: initial;
+ border-collapse: separate;
+ border-spacing: 0;
+ display: table;
+ font-size: 14px;
+ line-height: 1.55;
+ width: max-content;
+ min-width: 0;
+ }
+
+ :deep(table thead) {
+ background-color: color-mix(in srgb, var(--td-bg-color-secondarycontainer) 75%, var(--td-bg-color-container));
+ }
+
+ :deep(table tbody tr:nth-child(2n)) {
+ background-color: color-mix(in srgb, var(--td-bg-color-secondarycontainer) 45%, transparent);
+ }
+
+ :deep(table tr th) {
+ font-weight: 600;
+ border: 0;
+ border-right: 1px solid var(--td-component-stroke);
+ border-bottom: 1px solid var(--td-component-stroke);
+ background-color: color-mix(in srgb, var(--td-bg-color-secondarycontainer) 75%, var(--td-bg-color-container));
+ text-align: left;
+ margin: 0;
+ padding: 8px 12px;
+ white-space: nowrap;
+ }
+
+ :deep(table tr td) {
+ border: 0;
+ border-right: 1px solid var(--td-component-stroke);
+ border-bottom: 1px solid var(--td-component-stroke);
+ text-align: left;
+ margin: 0;
+ padding: 8px 12px;
+ vertical-align: top;
+ }
+
+ :deep(table tr th:last-child),
+ :deep(table tr td:last-child) {
+ border-right: 0;
+ }
+
+ :deep(table tbody tr:last-child td) {
+ border-bottom: 0;
+ }
+
+ :deep(table th[align='center']),
+ :deep(table td[align='center']) {
+ text-align: center;
+ }
+
+ :deep(table th[align='right']),
+ :deep(table td[align='right']) {
+ text-align: right;
+ }
+
+ :deep(img) {
+ max-width: 80%;
+ max-height: 300px;
+ width: auto;
+ height: auto;
+ border-radius: 8px;
+ display: block;
+ margin: 1.25em 0;
+ border: 0.5px solid var(--td-component-stroke);
+ object-fit: contain;
+ cursor: pointer;
+ transition: transform 0.2s ease;
+ }
+
+ :deep(p:has(> img:only-child)) {
+ margin: 1.25em 0;
+ line-height: 0;
+ }
+
+ :deep(.mermaid) {
+ margin: 0;
+ }
+
+ .chat-markdown-hljs();
+}
diff --git a/frontend/src/components/css/markdown.less b/frontend/src/components/css/markdown.less
index 203ef056..4bebe936 100644
--- a/frontend/src/components/css/markdown.less
+++ b/frontend/src/components/css/markdown.less
@@ -1,3 +1,5 @@
+// Legacy Markdown styles for non-chat document/editor surfaces that render
+// `.md-content`. Chat answer Markdown must use `chat-markdown.less` only.
:deep(.md-content) {
box-sizing: border-box !important;
@@ -440,4 +442,4 @@
.outline-label {
font-family: var(--app-font-family);
}
-}
\ No newline at end of file
+}
diff --git a/frontend/src/main.ts b/frontend/src/main.ts
index 075131de..36d734d7 100644
--- a/frontend/src/main.ts
+++ b/frontend/src/main.ts
@@ -8,6 +8,7 @@ import TDesign from "tdesign-vue-next";
import "tdesign-vue-next/es/style/index.css";
import "@/assets/theme/theme.css";
import "@/assets/dropdown-menu.less";
+import "@/components/css/chat-hljs-dark.less";
// vue-virtual-scroller ships its own tiny stylesheet — required for
// RecycleScroller/DynamicScroller to size their viewport correctly.
// Without it the scroller computes 0 height and renders no items.
diff --git a/frontend/src/utils/chatMarkdownRenderer.test.ts b/frontend/src/utils/chatMarkdownRenderer.test.ts
new file mode 100644
index 00000000..1dcf2656
--- /dev/null
+++ b/frontend/src/utils/chatMarkdownRenderer.test.ts
@@ -0,0 +1,181 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import {
+ createChatMarkdownRenderer,
+ preprocessMathDelimiters,
+ renderChatMarkdown,
+ replaceIncompleteImageWithPlaceholder,
+} from './chatMarkdownRenderer.ts'
+import { resolveCitationChunkId, joinCitationTagsToPreviousLine, collapseStandaloneCitationParagraphs } from './citationMarkdown.ts'
+
+const SAMPLE_DOC = 'example-report.docx'
+const SAMPLE_CHUNK_A = '00000001-0000-4000-8000-000000000001'
+const SAMPLE_CHUNK_B = '00000002-0000-4000-8000-000000000002'
+const SAMPLE_CHUNK_C = '00000003-0000-4000-8000-000000000003'
+const SAMPLE_CHUNK_PRESERVE = 'aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee'
+
+test('preprocessMathDelimiters converts escaped math delimiters for marked-katex', () => {
+ assert.equal(
+ preprocessMathDelimiters('inline \\(a+b\\) and block \\[x^2\\]'),
+ 'inline $a+b$ and block $$x^2$$',
+ )
+})
+
+test('replaceIncompleteImageWithPlaceholder hides an unfinished streaming image', () => {
+ assert.equal(
+ replaceIncompleteImageWithPlaceholder('before ,
+ 'before ',
+ )
+})
+
+test('renderChatMarkdown preserves citations, math, and sanitized output through one shared pipeline', () => {
+ const renderer = createChatMarkdownRenderer({
+ imageRenderer: ({ href, title, text }) =>
+ ``,
+ isValidImageUrl: (href) => href.startsWith('https://'),
+ })
+
+ const html = renderChatMarkdown(
+ [
+ 'See