Skip to main content

Crear diagramas

¿Quién puede utilizar esta característica?

Markdown se puede usar en la interfaz web de .

Puede crear diagramas en Markdown con cuatro sintaxis diferentes: Mermaid, geoJSON, topoJSON, y ASCII STL. La representación de diagramas está disponible en los archivos Issues, Discussions, solicitudes de incorporación de cambios, wikis y Markdown.

Mermaid es una herramienta inspirada en Markdown que representa texto en diagramas. Por ejemplo, Mermaid puede representar gráficos de flujo, diagramas de secuencia, gráficos circulares y mucho más. Para obtener más información, vea la documentación de Mermaid.

Para crear un diagrama de Mermaid, agregue la sintaxis de Mermaid dentro de un bloque de código delimitado con el identificador de idioma mermaid. Para más información sobre cómo crear bloques de código, consulta Crear y resaltar bloques de código.

Por ejemplo, puedes crear un gráfico de flujo especificando valores y flechas.

Here is a simple flow chart:

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

Captura de pantalla de un gráfico de flujo de Sirena representado con cuatro cuadros de lavanda etiquetados como A, B, C y D. Las flechas se extienden de A a B, de B a D, de A a C y de C a D.

Nota:

Es posible que observes errores si ejecutas un complemento de Mermaid de terceros al usar la sintaxis de Mermaid en .

Para asegurarse de que } admite la sintaxis de Mermaid, compruebe la versión de Mermaid que está actualmente en uso.

```mermaid
  info
```

Puedes usar la sintaxis GeoJSON o TopoJSON para crear mapas interactivos. Para crear un mapa, agrega GeoJSON o TopoJSON dentro de un bloque de código delimitado con el identificador de sintaxis geojson o topojson. Para más información, consulta Crear y resaltar bloques de código.

Para mostrar mapas interactivos, un administrador del sitio debe configurar la característica para tu instancia de Enterprise Server. Para más información, consulta Configuración de mapas interactivos.

Por ejemplo, puedes crear un mapa especificando coordenadas.

```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]
          ]
        ]
      }
    }
  ]
}
```

Captura de pantalla de un mapa GeoJSON representado del sudeste de Estados Unidos con una superposición rectangular púrpura en partes de Alabama y Misisipi.

Por ejemplo, puedes crear un mapa de TopoJSON especificando coordenadas y formas.

```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]]]
}
```

Captura de pantalla de un mapa TopoJSON representado de Indonesia, Singapur y Malasia con un punto azul, una superposición rectangular púrpura y líneas azules en zigzag.

Para más información sobre cómo trabajar con archivos .geojson y .topojson, consulta Trabajo con archivos que no son de código.

Puede usar la sintaxis STL ASCII directamente en Markdown para crear modelos 3D interactivos. Para mostrar un modelo, agregue la sintaxis STL ASCII dentro de un bloque de código cercado con el identificador de sintaxis stl. Para más información, consulta Crear y resaltar bloques de código.

Por ejemplo, puede crear un modelo 3D sencillo:

```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
```

Captura de pantalla de un modelo 3D de una pirámide azul sobre una cuadrícula de líneas negras. Las opciones "Wireframe" (Retícula), "Surface Angle" (Ángulo de superficie) o "Solid" (Sólido) aparecen en la parte inferior.

Para más información sobre cómo trabajar con archivos .stl, consulta Trabajo con archivos que no son de código.