创建图表

关于创建图表

您可以使用三种不同的语法在 Markdown 中创建图表：mermaid、geoJSON 和 topoJSON 以及 ASCII STL。图表渲染在 GitHub 问题、GitHub 讨论、拉取请求、Wiki 和 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 parts 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 atop a grid of black lines on a white ground. Options to select "Wireframe", "Surface Angle", or "Solid" appear at bottom.

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

本文档