Convertidor de CSV a Markdown

Los README, las descripciones de pull requests y los sitios de documentación renderizan estupendamente las tablas de Markdown, siempre que te molestes en escribir a mano las barras verticales y los guiones. Este convertidor lee un CSV, toma la primera fila como encabezado y emite una tabla de Markdown con formato de GitHub y la fila separadora correcta. Cada celda queda rodeada por delimitadores |, lista para pegar en un README o la descripción de un pull request.

Cómo se construye la tabla

  1. 1

    Pega el CSV

    Por defecto, es una muestra de tres columnas; cámbiala por tus propios datos.

  2. 2

    Elige el delimitador

    Coma por defecto. Elige tabulación, punto y coma o barra vertical de la lista para que coincida con tus datos.

  3. 3

    La fila 1 es el encabezado

    La primera fila se emite como el encabezado de Markdown, seguida de la línea de separador requerida `| --- | --- |`.

  4. 4

    Filas con ancho ajustado

    Si una fila de datos tiene menos celdas que el encabezado, el convertidor agrega cadenas vacías para mantener la tabla rectangular.

Renderización, alineación y dónde funcionará y no funcionará

Las tablas de Markdown con formato de GitHub (GFM) tienen una compatibilidad amplia pero no universal. Saber dónde se renderizan marca la diferencia entre un README impecable y un muro de barras verticales.

Soportado en

  • Pull requests y wikis de GitHub, GitLab y Bitbucket
  • La mayoría de los generadores de sitios estáticos (Docusaurus, VitePress, MkDocs Material)
  • Vista previa de Markdown en VS Code
  • Notion (a través de pegar como markdown)

No soportado en

  • CommonMark sin la extensión GFM
  • Reddit (usa su propio subconjunto)
  • Algunos motores de wiki heredados (DokuWiki, MoinMoin)

Alineación de columnas

Las tablas GFM soportan alineación izquierda, centrada y derecha a través de dos puntos en la fila de separador. Este convertidor emite separadores simples ---; si necesitas alineación, procesa después:

Sintaxis Efecto
:--- Alinear a la izquierda
:---: Alinear al centro
---: Alinear a la derecha

Reemplaza la línea de separador con | :--- | :---: | ---: | coincidiendo con las columnas que deseas inclinar.

Cómo escapar caracteres en las celdas de Markdown

  • Las barras verticales (|) dentro de una celda deben escaparse como \\| para evitar que la celda se divida. El convertidor no las escapa automáticamente, así que límpialas antes si tus datos contienen barras verticales.
  • Los saltos de línea dentro de una celda rompen la renderización de GFM. Reemplázalos con <br> antes de la conversión si quieres saltos de línea suaves dentro de una celda.
  • Los asteriscos, guiones bajos y comillas invertidas pasan sin cambios; se interpretan como énfasis de Markdown o código. Escápalos con una barra invertida al principio si los quieres literales.

Preguntas frecuentes

No por defecto: la fila de separador es simplemente ---. Reemplázala con :---, :---: o ---: después de la conversión para fijar la columna a la izquierda, al centro o a la derecha.

Escápalos con una barra invertida antes de la conversión, convirtiendo | en \|. De lo contrario, el renderizador de Markdown los trata como separadores de columna y rompe la tabla.

Las tablas GFM se renderizan en GitHub, GitLab, la mayoría de los generadores de sitios estáticos y VS Code. No se renderizan en CommonMark puro, Reddit o algunos wikis heredados sin un complemento.

Sí. El CSV se envía a nuestro servidor para que el convertidor pueda construir la tabla. No se almacena y no se añade al enlace de la página.

Herramientas relacionadas