jueves, 9 de octubre de 2025

Cómo convertir un texto markdown a html en linux

 

Para convertir un texto Markdown a HTML en Ubuntu Linux, existen varias herramientas que puedes usar desde la línea de comandos. A continuación, te detallo las opciones más comunes y los pasos para hacerlo, asegurándome de que sean claros y precisos.

Opción 1: Usar Pandoc (Recomendado)

Pandoc es una herramienta versátil y poderosa para convertir documentos entre formatos, incluyendo Markdown a HTML.

Instalación de Pandoc

  1. Abre una terminal (Ctrl+Alt+T).

  2. Actualiza los paquetes:

    sudo apt update
  3. Instala Pandoc:

    sudo apt install pandoc

Convertir Markdown a HTML

  1. Crea o ten listo tu archivo Markdown, por ejemplo, archivo.md.

  2. Usa el siguiente comando para convertirlo a HTML:

    pandoc archivo.md -o archivo.html
    • archivo.md: el archivo Markdown de entrada.
    • -o archivo.html: especifica el nombre del archivo HTML de salida.
  3. Opcionalmente, puedes agregar un estilo CSS para mejorar la apariencia:

    pandoc archivo.md -o archivo.html --standalone --css=estilo.css
    • --standalone: genera un archivo HTML completo con <html>, <head>, y <body>.
    • --css=estilo.css: incluye un archivo CSS personalizado (debes crearlo previamente).
  4. Verifica el resultado abriendo archivo.html en un navegador:

    xdg-open archivo.html

Ejemplo

Si tienes un archivo ejemplo.md con:

# Título
Este es un **texto** en Markdown.
- Punto 1
- Punto 2

Ejecuta:

pandoc ejemplo.md -o ejemplo.html --standalone

El resultado será un archivo ejemplo.html con el contenido formateado.

Opción 2: Usar Markdown (markdown_py)

El paquete markdown de Python es otra opción ligera para convertir Markdown a HTML.

Instalación

  1. Instala Python y pip si no los tienes:

    sudo apt install python3 python3-pip
  2. Instala el módulo markdown:

    pip3 install markdown

Convertir Markdown a HTML

  1. Convierte el archivo Markdown con:

    python3 -m markdown archivo.md > archivo.html
    • Esto genera un HTML básico (solo el contenido, sin <html> ni <head>).
  2. Si quieres un HTML completo, combina con un archivo CSS manualmente o usa Pandoc en su lugar.

Opción 3: Usar Grip (Vista previa en tiempo real)

Grip es una herramienta que convierte Markdown a HTML y puede servirlo en un navegador en tiempo real.

Instalación

  1. Instala Grip:

    pip3 install grip

Uso

  1. Convierte y visualiza el archivo Markdown:

    grip archivo.md
    • Esto inicia un servidor web local (normalmente en http://localhost:6419).
    • Abre la URL en tu navegador para ver el HTML renderizado.
  2. Para exportar a un archivo HTML:

    grip archivo.md --export archivo.html

Notas

  • Pandoc es la opción más robusta, ya que soporta múltiples formatos y personalizaciones (plantillas, CSS, metadatos).

  • markdown_py es más ligero, pero genera HTML básico.

  • Grip es ideal para previsualizaciones rápidas o si prefieres una interfaz web.

  • Si necesitas un estilo visual, crea un archivo CSS o usa una plantilla predefinida (por ejemplo, GitHub Markdown CSS: https://github.com/sindresorhus/github-markdown-css).

  • Verifica la versión de las herramientas:

    pandoc --version
    python3 -m markdown --version
    grip --version

No hay comentarios:

Publicar un comentario