Conversores Notebook

Convierte notebooks entre Markdown, Scala (Databricks) y Jupyter (.ipynb), y archivos CSV en tablas Markdown, además de exportaciones MHTML de Jira, desde un formulario en la barra lateral de VS Code.

Sin Python. Sin dependencias externas. Toda la lógica está escrita en TypeScript y se ejecuta dentro del propio editor.

Características

🔄 Cinco conversiones: Markdown → Jupyter, Scala Databricks → Jupyter, Jupyter → Markdown, CSV → tabla Markdown y Jira MHTML → Markdown
📂 Elige el archivo con Examinar… o usa directamente el archivo activo del editor
📝 La ruta de salida se sugiere automáticamente (y puedes editarla)
📊 En Jupyter → Markdown, opción de incluir las salidas y errores de las celdas
📡 Transmisor QR: convierte un archivo o carpeta en una secuencia animada de códigos QR para transferirlo filmando la pantalla
⚡ Arranque instantáneo: cero dependencias que instalar

Conversiones disponibles

Conversión	Origen	Destino
Markdown → Jupyter	`.md`	`.ipynb`
Scala Databricks → Jupyter	`.scala`	`.ipynb`
Jupyter → Markdown	`.ipynb`	`.md`
CSV → tabla Markdown	`.csv`, `.tsv`	`.md`
Jira MHTML → Markdown	`.mhtml`, `.mht`	`.md`

Uso

Abre el panel Conversores en la barra de actividad (icono de flechas).
Elige la conversión que quieras.
Indica el archivo de entrada: escribe la ruta, pulsa Examinar…, o usa Usar archivo activo del editor para tomar el que ya tienes abierto.
La ruta de salida se rellena sola; ajústala si lo necesitas.
Pulsa Convertir. El archivo se genera y se abre en el editor.

Jupyter → Markdown

Hay una casilla para incluir las salidas y errores de las celdas en el Markdown resultante. Para no sobrescribir un .md de origen, la salida se sugiere con el sufijo _reconstruido.

CSV → tabla Markdown

Genera una tabla GFM lista para pegar en cualquier documento. El delimitador se detecta solo (coma, punto y coma, tabulación o barra vertical), respeta las comillas de RFC 4180 —incluidos los saltos de línea dentro de un campo, que se convierten en <br>— y escapa las barras verticales del dato para que no partan la columna.

Jira MHTML → Markdown

Convierte una incidencia exportada desde Jira como MHTML y genera un Markdown con el contexto, la descripción, las instrucciones de despliegue y la ventana de ejecución. Las secciones ausentes o que sólo conservan texto de plantilla se omiten; una nota real como «no aplica» sí se conserva.

Las imágenes usadas por las instrucciones se decodifican desde MIME y se guardan en una carpeta <nombre>_assets junto al Markdown. El conversor reescribe los enlaces para que se muestren localmente y excluye navegación, scripts, estilos, avatares y comentarios históricos de Jira.

Transmisor QR

En el mismo panel Conversores hay una segunda vista, Transmisor QR, que convierte cualquier archivo o carpeta en una secuencia de códigos QR:

Elige el origen (archivo o carpeta). Se comprime en ZIP en memoria.
El ZIP se parte en fragmentos (por defecto 2500 bytes) y cada fragmento se codifica como un QR con cabecera P:ii/nn|, precedido por un QR de sincronización SYNC|n.
Pulsa Preparar y abrir reproductor: se abre un panel en el editor que reproduce la secuencia en bucle (SYNC → datos → SYNC…).

En el reproductor puedes ajustar los ms por QR, los segundos de SYNC y excluir frames ya capturados con rangos tipo 0-5,12-69 (útil para repetir solo los que faltaron al escanear).

Requisitos

VS Code 1.85.0 o superior. Nada más.

Desarrollo

npm install
npm run compile   # o npm run watch

Pulsa F5 para abrir una ventana de desarrollo con la extensión cargada.

Estructura

src/
├── extension.ts            # webview del formulario + lectura/escritura de archivos
├── converters/
│   ├── index.ts            # registro de conversores (alimenta el formulario)
│   ├── types.ts            # ConvertResult + fábrica de notebook
│   ├── helpers.ts          # regex y utilidades compartidas
│   ├── mdToIpynb.ts
│   ├── scalaToIpynb.ts
│   ├── ipynbToMd.ts
│   └── mhtmlToMd.ts
└── qr/
    ├── encoder.ts          # ZIP (fflate) → fragmentos → QRs SVG (qrcode)
    ├── formView.ts         # vista lateral "Transmisor QR"
    └── playerPanel.ts      # panel reproductor de la secuencia

Conversores Notebook: Markdown, Databricks y Jupyter

Rasec A.J