amis/docs/zh-CN/components/markdown.md

title	description	type	group	menuName	icon	order
Markdown 渲染		0	⚙ 组件	Markdown 渲染		58

1.1.6 版本开始

基本用法

{
    "type": "page",
    "body": {
        "type": "markdown",
        "value": "# title\n markdown **text**"
    }
}

动态数据

动态数据可以通过 name 来关联，类似 static 组件

基于 Editor 和数据联动来实现预览功能

{
    "type": "form",
    "api": "/api/mock2/form/saveForm",
    "body": [
        {
            "type": "group",
            "body": [
                {
                    "type": "editor",
                    "name": "md",
                    "language": "markdown"
                },
                {
                    "type": "markdown",
                    "name": "md"
                }
            ]
        }

    ]
}

加载外部 markdown 文件

1.6.5 及以上版本

可以通过 src 属性来加载外部 markdown 文件，比如

{
    "type": "markdown",
    "src": "/api/mock2/sample/mirror?json=%7B%22status%22%3A0%2C%22data%22%3A%22%23%23%20title%20%5Cn%20content%22%7D"
}

这个接口的返回格式可以是两种，一种是 JSON，类似

{
    "status": 0,
    "msg": "",
    "data": "markdown"
}

另一种是返回 content-type 为 text/markdown 或 text/x-markdown 的纯文本。

视频

可以使用 ![text](video.mp4) 语法来嵌入视频。

支持 latex

3.6.0 及以上版本

公式渲染使用 KaTeX 实现，由于体积太大默认不提供，需要自己去下载，在页面中引入以下三个文件：

<link rel="stylesheet" href="katex/katex.min.css">
<script src="katex/katex.min.js"></script>
<script src="katex/contrib/auto-render.min.js"></script>

markdown 中的 $ 或 $$ 包裹的内容就能以公式展现，比如 $\sqrt{a^2 + b^2}$，如果是在代码中 \ 要转义为 \\

{
    "type": "page",
    "body": {
        "type": "markdown",
        "value": "$$\\hat{f} (\\xi)=\\int_{-\\infty}^{\\infty}f(x)e^{-2\\pi ix\\xi}dx$$"
    }
}

高级配置

1.8.1 及以上版本

有以下配置：

• html，是否支持 html 标签，默认 false
• linkify，是否自动识别链接，默认值是 true
• breaks，是否回车就是换行，默认 false

{
    "type": "page",
    "body": {
        "type": "markdown",
        "value": "# title\n <b>markdown</b>\n http://www.github.com/",
        "options": {
            linkify: false,
            html: true,
            breaks: true
        }
    }
}

属性表

属性名	类型	默认值	说明
name	string		名称
value	string		静态值
className	string		类名
src	Api		外部地址