bowenliang123/markdown-exporter

Markdown Exporter

O Markdown Exporter é uma Skill de Agente que transforma seu texto Markdown em uma ampla variedade de arquivos de formato profissional.

Este SKILL.md para Skills de Agente, a ferramenta de linha de comando e o pacote Python markdown-exporter são mantidos no repositório GitHub bowenliang123/markdown-exporter por bowenliang123.

Ferramentas e Formatos Suportados

Ferramenta	Entrada (Caminho do arquivo de texto Markdown ou estilos)	Saída (Caminho do arquivo exportado)
md_to_docx	📝 Texto Markdown	📄 Documento Word (.docx)
md_to_html	📝 Texto Markdown	🌐 Arquivo HTML (.html)
md_to_html_text	📝 Texto Markdown	🌐 String de texto HTML
md_to_jira	📝 Texto Markdown	🅹 Texto de marcação Jira wiki
md_to_pdf	📝 Texto Markdown	📑 Arquivo PDF (.pdf)
md_to_png	📝 Texto Markdown	🖼️ Imagem PNG (.png), página longa única ou uma imagem por página
md_to_svg	📝 Texto Markdown	🖼️ Imagem SVG (.svg), uma imagem por página
md_to_md	📝 Texto Markdown	📝 Arquivo Markdown (.md)
md_to_ipynb	📝 Texto Markdown	📓 Jupyter Notebook (.ipynb)
md_to_pptx	📝 Slides Markdown no estilo Pandoc	🎯 PowerPoint (.pptx)
md_to_xlsx	📋 Tabelas Markdown	📊 Planilha Excel (.xlsx)
md_to_csv	📋 Tabelas Markdown	📋 Arquivo CSV (.csv)
md_to_json	📋 Tabelas Markdown	📦 Arquivo JSON/JSONL (.json)
md_to_xml	📋 Tabelas Markdown	🏷️ Arquivo XML (.xml)
md_to_latex	📋 Tabelas Markdown	📝 Arquivo LaTeX (.tex)
md_to_codeblock	💻 Blocos de código em Markdown	📁 Arquivos de código por linguagem (.py, .js, .sh, etc.)

📦 Uso

Visão Geral

O Markdown Exporter está disponível como um pacote PyPI, que fornece uma interface de linha de comando contínua para todas as suas funcionalidades.

Instalação

# com pip
pip install md-exporter

# com uv 
uv tool install md-exporter

# no OpenClaw
npx clawhub install markdown-exporter

Verifique o comando markdown-exporter e seus usos:

markdown-exporter -h

markdown-exporter <subcomando> -h

Uso Básico

Use o comando markdown-exporter para acessar todas as ferramentas:

markdown-exporter <subcomando> <args> [opções]

Notas Importantes

• Todos os comandos suportam apenas caminhos de arquivo como entrada
• O pacote gerencia automaticamente todas as dependências
• Você pode executar o comando de qualquer lugar do seu sistema, sem necessidade de navegar até o diretório do projeto

🔧 Scripts

md_to_csv - Converter Tabelas Markdown para CSV

Converte tabelas Markdown para o formato de arquivo CSV.

Uso:

markdown-exporter md_to_csv <entrada> <saída> [opções]

Argumentos:

• entrada - Caminho do arquivo Markdown de entrada contendo tabelas
• saída - Caminho do arquivo CSV de saída

Opções:

• --strip-wrapper - Remover wrapper de bloco de código, se presente

Exemplos:

1. Conversão básica:

   markdown-exporter md_to_csv /caminho/entrada.md /caminho/saida.csv
   

   Isso converte todas as tabelas no arquivo Markdown de entrada para o formato CSV.

2. Com remoção de wrapper de bloco de código:

   markdown-exporter md_to_csv /caminho/entrada.md /caminho/saida.csv --strip-wrapper
   

   Isso remove quaisquer wrappers de blocos de código (```) antes de processar o Markdown.

Exemplo de Entrada Markdown: Use o exemplo "Texto Básico e Tabelas" da seção Exemplos de Entrada Markdown - Texto Básico e Tabelas abaixo.

---

md_to_pdf - Converter Markdown para PDF

Converte texto Markdown para o formato PDF com suporte para chinês, japonês e outros idiomas.

Uso:

markdown-exporter md_to_pdf <entrada> <saída> [opções]

Argumentos:

• entrada - Caminho do arquivo Markdown de entrada
• saída - Caminho do arquivo PDF de saída

Opções:

• --strip-wrapper - Remover wrapper de bloco de código, se presente

Exemplos:

1. Conversão básica:

   markdown-exporter md_to_pdf /caminho/entrada.md /caminho/saida.pdf
   

   Isso converte o arquivo Markdown inteiro em um documento PDF.

2. Com remoção de wrapper de bloco de código:

   markdown-exporter md_to_pdf /caminho/entrada.md /caminho/saida.pdf --strip-wrapper
   

   Isso remove quaisquer wrappers de blocos de código (```) antes de processar o Markdown.

Exemplo de Entrada Markdown: Use o exemplo "Texto Básico e Tabelas" da seção Exemplos de Entrada Markdown - Texto Básico e Tabelas abaixo.

---

md_to_png - Converter Markdown para PNG

Converte texto Markdown para imagem(ns) PNG, com suporte para chinês, japonês e outros idiomas.

Uso:

markdown-exporter md_to_png <entrada> <saída> [opções]

Argumentos:

• entrada - Caminho do arquivo Markdown de entrada
• saída - Caminho do arquivo PNG de saída

Opções:

• --multi-page - Exportar um PNG por página A4 (arquivos numerados) em vez de um único PNG de página longa
• --strip-wrapper - Remover wrapper de bloco de código, se presente

Exemplos:

1. Conversão básica (imagem de página longa única):

   markdown-exporter md_to_png /caminho/entrada.md /caminho/saida.png
   

   Isso renderiza o documento Markdown inteiro como uma única imagem PNG de página longa.

2. Saída de múltiplas páginas:

   markdown-exporter md_to_png /caminho/entrada.md /caminho/saida.png --multi-page
   

   Isso exporta um PNG por página A4, salvos como saida_1.png, saida_2.png, etc., quando o documento tem várias páginas.

3. Com remoção de wrapper de bloco de código:

   markdown-exporter md_to_png /caminho/entrada.md /caminho/saida.png --strip-wrapper
   

   Isso remove quaisquer wrappers de blocos de código (```) antes de processar o Markdown.

Exemplo de Entrada Markdown: Use o exemplo "Texto Básico e Tabelas" da seção Exemplos de Entrada Markdown - Texto Básico e Tabelas abaixo.

---

md_to_svg - Converter Markdown para SVG

Converte texto Markdown para imagem(ns) SVG, um SVG por página, com suporte para chinês, japonês e outros idiomas.

Uso:

markdown-exporter md_to_svg <entrada> <saída> [opções]

Argumentos:

• entrada - Caminho do arquivo Markdown de entrada
• saída - Caminho do arquivo SVG de saída

Opções:

• --strip-wrapper - Remover wrapper de bloco de código, se presente

Exemplos:

1. Conversão básica:

   markdown-exporter md_to_svg /caminho/entrada.md /caminho/saida.svg
   

   Isso converte o arquivo Markdown em imagem(ns) SVG, salvos como saida_1.svg, saida_2.svg, etc., quando o documento tem várias páginas.

2. Com remoção de wrapper de bloco de código:

   markdown-exporter md_to_svg /caminho/entrada.md /caminho/saida.svg --strip-wrapper
   

   Isso remove quaisquer wrappers de blocos de código (```) antes de processar o Markdown.

Exemplo de Entrada Markdown: Use o exemplo "Texto Básico e Tabelas" da seção Exemplos de Entrada Markdown - Texto Básico e Tabelas abaixo.

---

md_to_docx - Converter Markdown para DOCX

Converte texto Markdown para arquivo no formato DOCX.

Uso:

markdown-exporter md_to_docx <entrada> <saída> [opções]

Argumentos:

• entrada - Caminho do arquivo Markdown de entrada
• saída - Caminho do arquivo DOCX de saída

Opções:

• --template - Caminho para o arquivo de modelo DOCX (opcional)
• --strip-wrapper - Remover wrapper de bloco de código, se presente

Exemplos:

1. Conversão básica:

   markdown-exporter md_to_docx /caminho/entrada.md /caminho/saida.docx
   

   Isso converte o arquivo Markdown inteiro em um documento DOCX.

2. Com modelo personalizado:

   markdown-exporter md_to_docx /caminho/entrada.md /caminho/saida.docx --template /caminho/modelo.docx
   

   Isso usa um modelo DOCX personalizado para estilização.

3. Com remoção de wrapper de bloco de código:

   markdown-exporter md_to_docx /caminho/entrada.md /caminho/saida.docx --strip-wrapper
   

   Isso remove quaisquer wrappers de blocos de código (```) antes de processar o Markdown.

Exemplo de Entrada Markdown: Use o exemplo "Texto Básico e Tabelas" da seção Exemplos de Entrada Markdown - Texto Básico e Tabelas abaixo.

---

md_to_xlsx - Converter Tabelas Markdown para XLSX

Converte tabelas Markdown para o formato XLSX com suporte a múltiplas planilhas.

Uso:

markdown-exporter md_to_xlsx <entrada> <saída> [opções]

Argumentos:

• entrada - Caminho do arquivo Markdown de entrada contendo tabelas
• saída - Caminho do arquivo XLSX de saída

Opções:

• --force-text - Converter valores de células para o tipo texto (padrão: True)
• --strip-wrapper - Remover wrapper de bloco de código, se presente

Exemplos:

1. Conversão básica:

   markdown-exporter md_to_xlsx /caminho/entrada.md /caminho/saida.xlsx
   

   Isso converte todas as tabelas no arquivo Markdown de entrada para uma pasta de trabalho XLSX, com cada tabela em uma planilha separada.

2. Com remoção de wrapper de bloco de código:

   markdown-exporter md_to_xlsx /caminho/entrada.md /caminho/saida.xlsx --strip-wrapper
   

   Isso remove quaisquer wrappers de blocos de código (```) antes de processar o Markdown.

3. Com force-text desabilitado:

   markdown-exporter md_to_xlsx /caminho/entrada.md /caminho/saida.xlsx --force-text False
   

   Isso permite que o Excel determine automaticamente os tipos de células.

Exemplo de Entrada Markdown: Use o exemplo "Texto Básico e Tabelas" da seção Exemplos de Entrada Markdown - Texto Básico e Tabelas abaixo.

---

md_to_pptx - Converter Markdown para PPTX

Converte texto Markdown para arquivo no formato PPTX.

Uso:

markdown-exporter md_to_pptx <entrada> <saída> [opções]

Argumentos:

• entrada - Caminho do arquivo Markdown de entrada
• saída - Caminho do arquivo PPTX de saída

Opções:

• --template - Caminho para o arquivo de modelo PPTX (opcional)

Exemplos:

1. Conversão básica:

   markdown-exporter md_to_pptx /caminho/entrada.md /caminho/saida.pptx
   

   Isso converte o arquivo Markdown em uma apresentação PowerPoint.

2. Com modelo personalizado:

   markdown-exporter md_to_pptx /caminho/entrada.md /caminho/saida.pptx --template /caminho/modelo.pptx
   

   Isso usa um modelo PowerPoint personalizado para estilização.

Exemplo de Entrada Markdown: Use o exemplo "Slides (para PPTX)" da seção Exemplos de Entrada Markdown - Slides (para PPTX) abaixo.

---

md_to_codeblock - Extrair Blocos de Código para Arquivos

Extrai blocos de código do Markdown e os salva como arquivos individuais.

Uso:

markdown-exporter md_to_codeblock <entrada> <saída> [opções]

Argumentos:

• entrada - Caminho do arquivo Markdown de entrada contendo blocos de código
• saída - Caminho do diretório de saída ou caminho do arquivo ZIP

Opções:

• --compress - Comprimir todos os blocos de código em um arquivo ZIP

Exemplos:

1. Extrair para diretório:

   markdown-exporter md_to_codeblock /caminho/entrada.md /caminho/diretorio_saida
   

   Isso extrai todos os blocos de código para arquivos individuais no diretório especificado.

2. Extrair para arquivo ZIP:

   markdown-exporter md_to_codeblock /caminho/entrada.md /caminho/saida.zip --compress
   

   Isso extrai todos os blocos de código e os compacta em um arquivo ZIP.

Exemplo de Entrada Markdown: Use o exemplo "Blocos de Código" da seção Exemplos de Entrada Markdown - Blocos de Código abaixo.

---

md_to_json - Converter Tabelas Markdown para JSON

Converte tabelas Markdown para arquivo no formato JSON ou JSONL.

Uso:

markdown-exporter md_to_json <entrada> <saída> [opções]

Argumentos:

• entrada - Caminho do arquivo Markdown de entrada contendo tabelas
• saída - Caminho do arquivo JSON de saída

Opções:

• --style - Estilo de saída JSON: jsonl (padrão) ou json_array
• --strip-wrapper - Remover wrapper de bloco de código, se presente

Exemplos:

1. Conversão básica (formato JSONL):

   markdown-exporter md_to_json /caminho/entrada.md /caminho/saida.json
   

   Isso converte tabelas para o formato JSON Lines (um objeto JSON por linha).

2. Converter para array JSON:

   markdown-exporter md_to_json /caminho/entrada.md /caminho/saida.json --style json_array
   

   Isso converte tabelas em um único array JSON de objetos.

3. Com remoção de wrapper de bloco de código:

   markdown-exporter md_to_json /caminho/entrada.md /caminho/saida.json --strip-wrapper
   

   Isso remove quaisquer wrappers de blocos de código (```) antes de processar o Markdown.

Exemplo de Entrada Markdown: Use o exemplo "Texto Básico e Tabelas" da seção Exemplos de Entrada Markdown - Texto Básico e Tabelas abaixo.

---

md_to_xml - Converter Markdown para XML

Converte texto Markdown para arquivo no formato XML.

Uso:

markdown-exporter md_to_xml <entrada> <saída> [opções]

Argumentos:

• entrada - Caminho do arquivo Markdown de entrada
• saída - Caminho do arquivo XML de saída

Opções:

• --strip-wrapper - Remover wrapper de bloco de código, se presente

Exemplos:

1. Conversão básica:

   markdown-exporter md_to_xml /caminho/entrada.md /caminho/saida.xml
   

   Isso converte o arquivo Markdown inteiro em um documento XML.

2. Com remoção de wrapper de bloco de código:

   markdown-exporter md_to_xml /caminho/entrada.md /caminho/saida.xml --strip-wrapper
   

   Isso remove quaisquer wrappers de blocos de código (```) antes de processar o Markdown.

Exemplo de Entrada Markdown: Use o exemplo "Texto Básico e Tabelas" da seção Exemplos de Entrada Markdown - Texto Básico e Tabelas abaixo.

---

md_to_latex - Converter Tabelas Markdown para LaTeX

Converte tabelas Markdown para arquivo no formato LaTeX.

Uso:

markdown-exporter md_to_latex <entrada> <saída> [opções]

Argumentos:

• entrada - Caminho do arquivo Markdown de entrada contendo tabelas
• saída - Caminho do arquivo LaTeX de saída

Opções:

• --strip-wrapper - Remover wrapper de bloco de código, se presente

Exemplos:

...