创建图表

关于创建图表

您可以在 Markdown 中使用四种语法（mermaid、geoJSON、topoJSON 和 ASCII STL）创建图表。图表渲染支持 GitHub Issues、GitHub Discussions、拉取请求、维基以及 Markdown 文件。

创建 Mermaid 图表

Mermaid 是受 Markdown 启发的工具，可将文本渲染为图表。例如，Mermaid 能渲染流程图、时序图、饼图等。了解更多信息，请参阅 Mermaid 文档。

要创建 Mermaid 图表，请在使用 mermaid 语言标识符的围栏代码块中加入 Mermaid 语法。有关创建代码块的更多信息，请参阅创建和高亮代码块。

例如，您可以通过指定数值和箭头来创建流程图。

Here is a simple flow chart:

```mermaid
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;
```

Screenshot of a rendered Mermaid flow chart with four lavender boxes labeled A, B, C, and D. Arrows extend from A to B, B to D, A to C, and C to D.

注意

在 GitHub 上使用 Mermaid 语法时，如果运行第三方 Mermaid 插件，可能会出现错误。

检查 Mermaid 版本

为确保 GitHub 支持您使用的 Mermaid 语法，请检查当前使用的 Mermaid 版本。

```mermaid
  info
```

创建 GeoJSON 与 TopoJSON 地图

您可以使用 GeoJSON 或 TopoJSON 语法创建交互式地图。要创建地图，请在使用 geojson 或 topojson 语法标识符的围栏代码块中加入相应的 GeoJSON 或 TopoJSON。更多信息请参阅创建和高亮代码块。

使用 GeoJSON

例如，您可以通过指定坐标来创建地图。

```geojson
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": 1,
      "properties": {
        "ID": 0
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
              [-90,35],
              [-90,30],
              [-85,30],
              [-85,35],
              [-90,35]
          ]
        ]
      }
    }
  ]
}
```

Screenshot of a rendered GeoJSON map of the southeastern United States with a purple rectangular overlay over parts of Alabama and Mississippi.

使用 TopoJSON

例如，您可以通过指定坐标和形状来创建 TopoJSON 地图。

```topojson
{
  "type": "Topology",
  "transform": {
    "scale": [0.0005000500050005, 0.00010001000100010001],
    "translate": [100, 0]
  },
  "objects": {
    "example": {
      "type": "GeometryCollection",
      "geometries": [
        {
          "type": "Point",
          "properties": {"prop0": "value0"},
          "coordinates": [4000, 5000]
        },
        {
          "type": "LineString",
          "properties": {"prop0": "value0", "prop1": 0},
          "arcs": [0]
        },
        {
          "type": "Polygon",
          "properties": {"prop0": "value0",
            "prop1": {"this": "that"}
          },
          "arcs": [[1]]
        }
      ]
    }
  },
  "arcs": [[[4000, 0], [1999, 9999], [2000, -9999], [2000, 9999]],[[0, 0], [0, 9999], [2000, 0], [0, -9999], [-2000, 0]]]
}
```

Screenshot of a rendered TopoJSON map of Indonesia, Singapore, and Malaysia with a blue point, a purple rectangular overlay, and blue zigzag lines.

有关 .geojson 和 .topojson 文件的更多使用信息，请参阅非代码文件的使用方法。

创建 STL 3D 模型

您可以直接在 Markdown 中使用 ASCII STL 语法创建交互式 3D 模型。要显示模型，请在使用 stl 语法标识符的围栏代码块中加入 ASCII STL 语法。更多信息请参阅创建和高亮代码块。

例如，您可以创建一个简单的 3D 模型

```stl
solid cube_corner
  facet normal 0.0 -1.0 0.0
    outer loop
      vertex 0.0 0.0 0.0
      vertex 1.0 0.0 0.0
      vertex 0.0 0.0 1.0
    endloop
  endfacet
  facet normal 0.0 0.0 -1.0
    outer loop
      vertex 0.0 0.0 0.0
      vertex 0.0 1.0 0.0
      vertex 1.0 0.0 0.0
    endloop
  endfacet
  facet normal -1.0 0.0 0.0
    outer loop
      vertex 0.0 0.0 0.0
      vertex 0.0 0.0 1.0
      vertex 0.0 1.0 0.0
    endloop
  endfacet
  facet normal 0.577 0.577 0.577
    outer loop
      vertex 1.0 0.0 0.0
      vertex 0.0 1.0 0.0
      vertex 0.0 0.0 1.0
    endloop
  endfacet
endsolid
```

Screenshot of a 3D model of a blue pyramid on a grid of black lines. Options "Wireframe", "Surface Angle", or "Solid" appear at bottom.

有关 .stl 文件的更多使用信息，请参阅非代码文件的使用方法。

谁可以使用此功能？

本文内容