bowenliang123/markdown-exporter

Markdown Exporter

Markdown Exporter es una habilidad de agente que transforma tu texto Markdown en una amplia variedad de archivos de formato profesional.

Este SKILL.md para habilidades de agente, la herramienta CLI y el paquete Python markdown-exporter se mantienen en el repositorio de GitHub bowenliang123/markdown-exporter por bowenliang123.

Herramientas y Formatos Soportados

Herramienta	Entrada (Ruta de archivo de texto o estilos Markdown)	Salida (Ruta de archivo exportado)
md_to_docx	📝 Texto Markdown	📄 Documento Word (.docx)
md_to_html	📝 Texto Markdown	🌐 Archivo HTML (.html)
md_to_html_text	📝 Texto Markdown	🌐 Cadena de texto HTML
md_to_jira	📝 Texto Markdown	🅹 Texto de marcado wiki de Jira
md_to_pdf	📝 Texto Markdown	📑 Archivo PDF (.pdf)
md_to_png	📝 Texto Markdown	🖼️ Imagen PNG (.png), una sola página larga o una imagen por página
md_to_svg	📝 Texto Markdown	🖼️ Imagen SVG (.svg), una imagen por página
md_to_md	📝 Texto Markdown	📝 Archivo Markdown (.md)
md_to_ipynb	📝 Texto Markdown	📓 Jupyter Notebook (.ipynb)
md_to_pptx	📝 Diapositivas Markdown en estilo Pandoc	🎯 PowerPoint (.pptx)
md_to_xlsx	📋 Tablas Markdown	📊 Hoja de cálculo Excel (.xlsx)
md_to_csv	📋 Tablas Markdown	📋 Archivo CSV (.csv)
md_to_json	📋 Tablas Markdown	📦 Archivo JSON/JSONL (.json)
md_to_xml	📋 Tablas Markdown	🏷️ Archivo XML (.xml)
md_to_latex	📋 Tablas Markdown	📝 Archivo LaTeX (.tex)
md_to_codeblock	💻 Bloques de código en Markdown	📁 Archivos de código por lenguaje (.py, .js, .sh, etc.)

📦 Uso

Resumen

Markdown Exporter está disponible como un paquete PyPI, que proporciona una interfaz de línea de comandos perfecta para todas sus funcionalidades.

Instalación

# con pip
pip install md-exporter

# con uv 
uv tool install md-exporter

# en OpenClaw
npx clawhub install markdown-exporter

Verifica el comando markdown-exporter y sus usos:

markdown-exporter -h

markdown-exporter <subcomando> -h

Uso Básico

Usa el comando markdown-exporter para acceder a todas las herramientas:

markdown-exporter <subcomando> <args> [opciones]

Notas Importantes

• Todos los comandos solo aceptan rutas de archivo como entrada
• El paquete maneja automáticamente toda la gestión de dependencias
• Puedes ejecutar el comando desde cualquier lugar de tu sistema, sin necesidad de navegar al directorio del proyecto

🔧 Scripts

md_to_csv - Convertir tablas Markdown a CSV

Convierte tablas Markdown al formato CSV.

Uso:

markdown-exporter md_to_csv <entrada> <salida> [opciones]

Argumentos:

• entrada - Ruta del archivo Markdown de entrada que contiene las tablas
• salida - Ruta del archivo CSV de salida

Opciones:

• --strip-wrapper - Elimina el envoltorio del bloque de código, si está presente

Ejemplos:

1. Conversión básica:

   markdown-exporter md_to_csv /ruta/entrada.md /ruta/salida.csv
   

   Esto convierte todas las tablas del archivo Markdown de entrada al formato CSV.

2. Con eliminación del envoltorio del bloque de código:

   markdown-exporter md_to_csv /ruta/entrada.md /ruta/salida.csv --strip-wrapper
   

   Esto elimina cualquier envoltorio de bloque de código (```) antes de procesar el Markdown.

Entrada Markdown de ejemplo: Usa el ejemplo "Texto básico y tablas" de la sección Entradas Markdown de ejemplo - Texto básico y tablas a continuación.

---

md_to_pdf - Convertir Markdown a PDF

Convierte texto Markdown al formato PDF, con soporte para chino, japonés y otros idiomas.

Uso:

markdown-exporter md_to_pdf <entrada> <salida> [opciones]

Argumentos:

• entrada - Ruta del archivo Markdown de entrada
• salida - Ruta del archivo PDF de salida

Opciones:

• --strip-wrapper - Elimina el envoltorio del bloque de código, si está presente

Ejemplos:

1. Conversión básica:

   markdown-exporter md_to_pdf /ruta/entrada.md /ruta/salida.pdf
   

   Esto convierte todo el archivo Markdown a un documento PDF.

2. Con eliminación del envoltorio del bloque de código:

   markdown-exporter md_to_pdf /ruta/entrada.md /ruta/salida.pdf --strip-wrapper
   

   Esto elimina cualquier envoltorio de bloque de código (```) antes de procesar el Markdown.

Entrada Markdown de ejemplo: Usa el ejemplo "Texto básico y tablas" de la sección Entradas Markdown de ejemplo - Texto básico y tablas a continuación.

---

md_to_png - Convertir Markdown a PNG

Convierte texto Markdown a imagen(es) PNG, con soporte para chino, japonés y otros idiomas.

Uso:

markdown-exporter md_to_png <entrada> <salida> [opciones]

Argumentos:

• entrada - Ruta del archivo Markdown de entrada
• salida - Ruta del archivo PNG de salida

Opciones:

• --multi-page - Exporta un PNG por página A4 (archivos numerados) en lugar de un único PNG de página larga
• --strip-wrapper - Elimina el envoltorio del bloque de código, si está presente

Ejemplos:

1. Conversión básica (imagen de una sola página larga):

   markdown-exporter md_to_png /ruta/entrada.md /ruta/salida.png
   

   Esto renderiza todo el documento Markdown como una única imagen PNG de página larga.

2. Salida multipágina:

   markdown-exporter md_to_png /ruta/entrada.md /ruta/salida.png --multi-page
   

   Esto exporta un PNG por página A4, guardado como salida_1.png, salida_2.png, etc., cuando el documento tiene varias páginas.

3. Con eliminación del envoltorio del bloque de código:

   markdown-exporter md_to_png /ruta/entrada.md /ruta/salida.png --strip-wrapper
   

   Esto elimina cualquier envoltorio de bloque de código (```) antes de procesar el Markdown.

Entrada Markdown de ejemplo: Usa el ejemplo "Texto básico y tablas" de la sección Entradas Markdown de ejemplo - Texto básico y tablas a continuación.

---

md_to_svg - Convertir Markdown a SVG

Convierte texto Markdown a imagen(es) SVG, un SVG por página, con soporte para chino, japonés y otros idiomas.

Uso:

markdown-exporter md_to_svg <entrada> <salida> [opciones]

Argumentos:

• entrada - Ruta del archivo Markdown de entrada
• salida - Ruta del archivo SVG de salida

Opciones:

• --strip-wrapper - Elimina el envoltorio del bloque de código, si está presente

Ejemplos:

1. Conversión básica:

   markdown-exporter md_to_svg /ruta/entrada.md /ruta/salida.svg
   

   Esto convierte el archivo Markdown a imagen(es) SVG, guardado como salida_1.svg, salida_2.svg, etc., cuando el documento tiene varias páginas.

2. Con eliminación del envoltorio del bloque de código:

   markdown-exporter md_to_svg /ruta/entrada.md /ruta/salida.svg --strip-wrapper
   

   Esto elimina cualquier envoltorio de bloque de código (```) antes de procesar el Markdown.

Entrada Markdown de ejemplo: Usa el ejemplo "Texto básico y tablas" de la sección Entradas Markdown de ejemplo - Texto básico y tablas a continuación.

---

md_to_docx - Convertir Markdown a DOCX

Convierte texto Markdown al formato DOCX.

Uso:

markdown-exporter md_to_docx <entrada> <salida> [opciones]

Argumentos:

• entrada - Ruta del archivo Markdown de entrada
• salida - Ruta del archivo DOCX de salida

Opciones:

• --template - Ruta al archivo de plantilla DOCX (opcional)
• --strip-wrapper - Elimina el envoltorio del bloque de código, si está presente

Ejemplos:

1. Conversión básica:

   markdown-exporter md_to_docx /ruta/entrada.md /ruta/salida.docx
   

   Esto convierte todo el archivo Markdown a un documento DOCX.

2. Con plantilla personalizada:

   markdown-exporter md_to_docx /ruta/entrada.md /ruta/salida.docx --template /ruta/plantilla.docx
   

   Esto usa una plantilla DOCX personalizada para el estilo.

3. Con eliminación del envoltorio del bloque de código:

   markdown-exporter md_to_docx /ruta/entrada.md /ruta/salida.docx --strip-wrapper
   

   Esto elimina cualquier envoltorio de bloque de código (```) antes de procesar el Markdown.

Entrada Markdown de ejemplo: Usa el ejemplo "Texto básico y tablas" de la sección Entradas Markdown de ejemplo - Texto básico y tablas a continuación.

---

md_to_xlsx - Convertir tablas Markdown a XLSX

Convierte tablas Markdown al formato XLSX con soporte para múltiples hojas.

Uso:

markdown-exporter md_to_xlsx <entrada> <salida> [opciones]

Argumentos:

• entrada - Ruta del archivo Markdown de entrada que contiene las tablas
• salida - Ruta del archivo XLSX de salida

Opciones:

• --force-text - Convierte los valores de las celdas al tipo texto (por defecto: True)
• --strip-wrapper - Elimina el envoltorio del bloque de código, si está presente

Ejemplos:

1. Conversión básica:

   markdown-exporter md_to_xlsx /ruta/entrada.md /ruta/salida.xlsx
   

   Esto convierte todas las tablas del archivo Markdown de entrada a un libro de trabajo XLSX, con cada tabla en una hoja separada.

2. Con eliminación del envoltorio del bloque de código:

   markdown-exporter md_to_xlsx /ruta/entrada.md /ruta/salida.xlsx --strip-wrapper
   

   Esto elimina cualquier envoltorio de bloque de código (```) antes de procesar el Markdown.

3. Con force-text deshabilitado:

   markdown-exporter md_to_xlsx /ruta/entrada.md /ruta/salida.xlsx --force-text False
   

   Esto permite que Excel determine automáticamente los tipos de celda.

Entrada Markdown de ejemplo: Usa el ejemplo "Texto básico y tablas" de la sección Entradas Markdown de ejemplo - Texto básico y tablas a continuación.

---

md_to_pptx - Convertir Markdown a PPTX

Convierte texto Markdown al formato PPTX.

Uso:

markdown-exporter md_to_pptx <entrada> <salida> [opciones]

Argumentos:

• entrada - Ruta del archivo Markdown de entrada
• salida - Ruta del archivo PPTX de salida

Opciones:

• --template - Ruta al archivo de plantilla PPTX (opcional)

Ejemplos:

1. Conversión básica:

   markdown-exporter md_to_pptx /ruta/entrada.md /ruta/salida.pptx
   

   Esto convierte el archivo Markdown a una presentación de PowerPoint.

2. Con plantilla personalizada:

   markdown-exporter md_to_pptx /ruta/entrada.md /ruta/salida.pptx --template /ruta/plantilla.pptx
   

   Esto usa una plantilla PowerPoint personalizada para el estilo.

Entrada Markdown de ejemplo: Usa el ejemplo "Diapositivas (para PPTX)" de la sección Entradas Markdown de ejemplo - Diapositivas (para PPTX) a continuación.

---

md_to_codeblock - Extraer bloques de código a archivos

Extrae bloques de código de Markdown y los guarda como archivos individuales.

Uso:

markdown-exporter md_to_codeblock <entrada> <salida> [opciones]

Argumentos:

• entrada - Ruta del archivo Markdown de entrada que contiene bloques de código
• salida - Ruta del directorio de salida o ruta del archivo ZIP

Opciones:

• --compress - Comprime todos los bloques de código en un archivo ZIP

Ejemplos:

1. Extraer al directorio:

   markdown-exporter md_to_codeblock /ruta/entrada.md /ruta/directorio_salida
   

   Esto extrae todos los bloques de código a archivos individuales en el directorio especificado.

2. Extraer a un archivo ZIP:

   markdown-exporter md_to_codeblock /ruta/entrada.md /ruta/salida.zip --compress
   

   Esto extrae todos los bloques de código y los comprime en un archivo ZIP.

Entrada Markdown de ejemplo: Usa el ejemplo "Bloques de código" de la sección Entradas Markdown de ejemplo - Bloques de código a continuación.

---

md_to_json - Convertir tablas Markdown a JSON

Convierte tablas Markdown al formato JSON o JSONL.

Uso:

markdown-exporter md_to_json <entrada> <salida> [opciones]

Argumentos:

• entrada - Ruta del archivo Markdown de entrada que contiene las tablas
• salida - Ruta del archivo JSON de salida

Opciones:

• --style - Estilo de salida JSON: jsonl (por defecto) o json_array
• --strip-wrapper - Elimina el envoltorio del bloque de código, si está presente

Ejemplos:

1. Conversión básica (formato JSONL):

   markdown-exporter md_to_json /ruta/entrada.md /ruta/salida.json
   

   Esto convierte las tablas al formato JSON Lines (un objeto JSON por línea).

2. Convertir a array JSON:

   markdown-exporter md_to_json /ruta/entrada.md /ruta/salida.json --style json_array
   

   Esto convierte las tablas a un único array JSON de objetos.

3. Con eliminación del envoltorio del bloque de código:

   markdown-exporter md_to_json /ruta/entrada.md /ruta/salida.json --strip-wrapper
   

   Esto elimina cualquier envoltorio de bloque de código (```) antes de procesar el Markdown.

Entrada Markdown de ejemplo: Usa el ejemplo "Texto básico y tablas" de la sección Entradas Markdown de ejemplo - Texto básico y tablas a continuación.

---

md_to_xml - Convertir Markdown a XML

Convierte texto Markdown al formato XML.

Uso:

markdown-exporter md_to_xml <entrada> <salida> [opciones]

Argumentos:

• entrada - Ruta del archivo Markdown de entrada
• salida - Ruta del archivo XML de salida

Opciones:

• --strip-wrapper - Elimina el envoltorio del bloque de código, si está presente

Ejemplos:

1. Conversión básica:

   markdown-exporter md_to_xml /ruta/entrada.md /ruta/salida.xml
   

   Esto convierte todo el archivo Markdown a un documento XML.

2. Con eliminación del envoltorio del bloque de código:

   markdown-exporter md_to_xml /ruta/entrada.md /ruta/salida.xml --strip-wrapper
   

   Esto elimina cualquier envoltorio de bloque de código (```) antes de procesar el Markdown.

Entrada Markdown de ejemplo: Usa el ejemplo "Texto básico y tablas" de la sección Entradas Markdown de ejemplo - Texto básico y tablas a continuación.

---

md_to_latex - Convertir tablas Markdown a LaTeX

Convierte tablas Markdown al formato LaTeX.

Uso:

markdown-exporter md_to_latex <entrada> <salida> [opciones]

Argumentos:

• entrada - Ruta del archivo Markdown de entrada que contiene las tablas
• salida - Ruta del archivo LaTeX de salida

Opciones:

• --strip-wrapper - Elimina el envoltorio del bloque de código, si está presente

Ejemplos:

… [truncado para la traducción]