feat: 替换了markdown 的组件

2025-07-26 10:22:41 +08:00
parent 5321b27176
commit cb22c0531c
25 changed files with 3697 additions and 5942 deletions
--- a/uni_modules/zero-markdown-view/readme.md
+++ b/uni_modules/zero-markdown-view/readme.md
@@ -0,0 +1,133 @@
+# zero-markdown-view
+
+## 一. 重要更新说明
+
+### v3.0.0
+
+- 优化了代码块流式输出
+- 增加aiMode模式（内容靠左对齐的，样式区别于普通模式）
+
+
+### v2.1.0
+
+- 新增 latex 公式支持
+- 代码块高亮支持: languages=markup+css+clike+javascript+c+cpp+go+java+markup-templating+php+python+rust
+- 代码包体积增加了不少(注意)
+
+### v2.0.4 (仅需要基础功能可以使用此版本)
+
+- 新增点击代码块复制代码-仅小程序可用
+
+### v2.0.0
+
+- 省去了 npm install marked
+- 省去了 npm install highlight.js
+- 使用 mp-html 自带的插件,重新生成 uniapp 包,大幅减少插件体积
+  传送门: [优化思路及详细过程](https://juejin.cn/post/7160995270476431373/) https://juejin.cn/post/7160995270476431373/
+
+## 二. 使用方法
+
+> 建议放到分包里手动引入该插件
+
+**符合`easycom`组件模式, 导入 `uni_modules` 后直接使用即可 **
+
+```html
+<template>
+  <view class="container">
+    <!-- 默认用法 直接传入md文本即可 普通md展示-->
+    <zero-markdown-view :markdown="content"></zero-markdown-view>
+
+	<!-- ai对话模式 -->
+	 <zero-markdown-view :markdown="msgContent" :aiMode='true'></zero-markdown-view>
+  </view>
+</template>
+<script>
+  export default {
+    data() {
+      return {
+        content: "## md格式的文本内容",
+		msgContent: "## ai回复的内容，兼容流式输出",
+      };
+    },
+    created() {},
+    methods: {},
+  };
+</script>
+<style lang="scss" scoped></style>
+```
+
+## 三. 参数说明
+
+| 参数        | 类型   | 默认值    | 描述          |
+| ----------- | ------ | --------- | ------------- |
+| markdown    | String |           | markdown 文本 |
+| themeColor  | String | '#007AFF' | 主题色        |
+| codeBgColor | String | '#2d2d2d' | 代码块背景色  |
+| aiMode      | Boolean| false     | 是否为 AI 模式（内容靠左对齐） |
+
+
+## 四. 注意事项
+
+### 关于代码块高亮
+
+如果需要更多语言或更换主题请前往 prism 官网 下载对应的 prism.min.js 和 prism.css 并替换 plugins/highlight/ 目录下的文件,重新运行打包命令并替换 mp-html. 不建议这样做,因为本插件还修改过其他地方,可能会导致插件不能正常使用.
+具体请参考 mp-html 的文档,在文末有链接
+
+### 关于代码块流式输出闪烁,可以尝试 给代码块后增加 `\n`
+
+#### 已经在组件内的 `aiMode` 解决，不需要自行处理,也就是说，如何你是是用在ai上，直接把ai回复内容传给组件就可以了
+#### 已经在组件内的 `aiMode` 解决，不需要自行处理,也就是说，如何你是是用在ai上，直接把ai回复内容传给组件就可以了
+#### 已经在组件内的 `aiMode` 解决，不需要自行处理,也就是说，如何你是是用在ai上，直接把ai回复内容传给组件就可以了
+
+
+> 注意小程序上的流逝输出需要结合unipush2使用
+
+> 感谢评论区的一个朋友提供的代码
+
+````javascript
+		computed: {
+						// 流式输出时代码块处理 , 这时候请使用 msgContent 传入组件中
+		msgContent() {
+			if (!this.markdown) {
+				return
+			}
+			let htmlString = ''
+			// 检查是否有未闭合的代码块
+			const codeBlocks = this.markdown.match(/```[\s\S]*?```|```[\s\S]*?$/g) || []
+			const lastBlock = codeBlocks[codeBlocks.length - 1]
+			if (lastBlock && !lastBlock.endsWith('```')) {
+				// 最后一个代码块未闭合,需要补上结束标识符
+				htmlString = this.markdown + '\n'
+			} else {
+				htmlString = this.markdown
+			}
+			return htmlString
+		},
+		},
+````
+
+### 如何关闭点击代码块复制功能?
+
+找到组件文件夹 `zero-markdown-view`-`mp-html`-`highlight`-`config.js`
+
+**把 `copyByClickCode` 改成 false 即可**
+
+```
+export default {
+  copyByClickCode: true, // 点击代码块复制
+  showLanguageName: true, // 是否在代码块右上角显示语言的名称
+}
+```
+
+### 感谢 mp-html 插件
+
+插件地址: [https://ext.dcloud.net.cn/plugin?id=805](https://ext.dcloud.net.cn/plugin?id=805)
+
+文档地址: [https://jin-yufeng.gitee.io/mp-html/#/overview/quickstart](https://jin-yufeng.gitee.io/mp-html/#/overview/quickstart)
+
+插件预览:
+![code](https://cdn.zerojs.cn/image/common/code-z_1722414660881_1.jpg?imageMogr2/thumbnail/200x)
+
+> 小程序搜索: 零技术
+
+> 预览的小程序不一定能及时更新当前插件