| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 1690 |
| Technical Name |
app_web_widget_markdown |
| License | LGPL-3 |
| Website | https://www.odooai.cn |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 1690 |
| Technical Name |
app_web_widget_markdown |
| License | LGPL-3 |
| Website | https://www.odooai.cn |
Markdown字段小部件 / Markdown Widget
Markdown field widget with local Mermaid diagram support for Odoo
为 Odoo 表单提供 Markdown 编辑/预览与 Mermaid 图表本地渲染，专为 AI LLM 对话设计
Full Markdown editing, preview and local Mermaid diagram rendering for Odoo forms, designed for AI LLM
功能概述 / Overview
在 Odoo 表单视图中为 text/html 字段提供 Markdown 编辑与实时预览，支持 Mermaid 图表（流程图、时序图、甘特图等）本地渲染，无需外网 CDN。纯 OWL 组件架构，零 jQuery 依赖，复用 Odoo 内置 Bootstrap 5.1.3。
Provides Markdown editing with live preview for text/html fields in Odoo forms, with built-in local Mermaid diagram rendering (flowchart, sequence, gantt, etc.) — no CDN needed. Pure OWL component, zero jQuery, reuses Odoo's built-in Bootstrap 5.1.3.
核心亮点 / Key Highlights
轻量、高效、无冗余依赖 / Lightweight, Efficient, Zero Redundancy
1. 完整 Markdown 语法
Full Markdown Syntax
marked.js + GFM Extension
基于 marked.js，支持标题、列表、链接、代码块、表格、引用、任务列表、删除线等完整 GFM 语法
2. Mermaid 图表本地渲染
Local Mermaid Rendering
Flowchart, Sequence, Gantt, Class Diagram
支持流程图、时序图、甘特图、类图等 Mermaid 图表，本地加载 mermaid.min.js，无需外网 CDN
3. 轻量无冗余
Lightweight & Zero Redundancy
~40KB extra, reuses Odoo Bootstrap 5.1.3
复用 Odoo 内置 Bootstrap 5.1.3，移除 jQuery / bootstrap-markdown / showdown 等冗余依赖
4. 编辑预览实时切换
Edit & Preview Toggle
One-click toggle, auto-preview in readonly
一键切换 Markdown 编辑与实时渲染预览，只读模式自动展示渲染结果
5. AI LLM 对话适配
AI LLM Integration
Prompt & Response fields
专为 AI LLM 提示与响应字段设计，完美展示 AI 生成内容
6. 向下兼容双部件名
Backward Compatible Dual Widget
widget="markdown" & widget="bootstrap_markdown"
支持 markdown 和 bootstrap_markdown 两种部件名，向下兼容旧视图，零迁移成本
通用特性 / General Features
多语言与多公司
Multi-Language & Multi-Company
完整的多语言翻译支持，适配全球化企业部署。原生多公司架构，数据严格隔离。
全版本兼容
Full Version Support
支持 Odoo 18,17,16,15,14，企业版、社区版及在线 SaaS.sh 版全版本兼容。
代码完全开源
Full Open Source
基于 LGPL-3 协议开源，代码透明可审计，支持二次开发与定制。
界面截图 / Screenshots
核心功能界面一览
Markdown 编辑与预览 / Markdown Edit & Preview
编辑预览模式切换 / Edit & Preview Toggle
Mermaid 图表渲染 / Mermaid Diagram Rendering
使用方法 / How to Use
安装模块
Install the module
添加 widget
Add widget="markdown"
编辑与预览
Edit & Preview
Mermaid 图表
Mermaid Diagrams
XML 视图示例 / XML View Example
<!-- Markdown widget -->
<field name="description" widget="markdown"/>
<!-- With placeholder -->
<field name="notes" widget="markdown"
placeholder="Enter markdown here..."/>
<!-- Backward compatible -->
<field name="ai_response" widget="bootstrap_markdown"/>Mermaid 语法示例 / Mermaid Example
```mermaid
graph TD
A[Start] --> B{Decision}
B -->|Yes| C[Action 1]
B -->|No| D[Action 2]
C --> E[End]
D --> E
```技术对比 / Technical Comparison
| 项目 / Item | app_web_widget_markdown |
|---|---|
| Markdown 解析器 / Markdown Parser | marked.js (完整 GFM) |
| Mermaid 图表 / Mermaid Diagrams | 支持（本地加载，无需CDN） / Supported (local, no CDN) |
| Bootstrap 依赖 / Bootstrap Dependency | 复用 Odoo 内置 / Reuses Odoo built-in |
| jQuery 依赖 / jQuery Dependency | 不需要（OWL 组件） / Not required (OWL component) |
| 额外加载量 / Extra Payload | ~40KB（仅 marked.js） / ~40KB (marked.js only) |
| OWL 模板 / OWL Template | 独立 XML 文件 / Standalone XML |
| 部件名 / Widget Names | markdown + bootstrap_markdown |
| 保存并发控制 / Save Concurrency | Mutex 互斥锁 / Mutex-based |
依赖模块 / Dependent Modules
- web / Odoo Web 核心
odooai.cn
专业Odoo服务伙伴-开发实施咨询培训全套解决方案 / Professional Odoo Solutions
Please log in to comment on this module