Tan Shuai
Change language: Português

Converter Rapidamente Markdown para PDF de Estilo Acadêmico no macOS

Desenvolvimento de Software

Neste guia, vou mostrar como converto documentos Markdown em PDFs no estilo de artigos acadêmicos no macOS usando Pandoc e BasicTeX. Este método é rápido e simples, perfeito para quando você precisa criar arquivos PDF com aparência profissional para seus artigos acadêmicos.

Passo 1: Instalar Pandoc e BasicTeX

Primeiro, você precisará instalar o Pandoc e o BasicTeX no seu sistema macOS. Veja como fiz isso:

  1. Instalar Pandoc: Abra o Terminal e insira o seguinte comando para instalar o Pandoc:

    brew install pandoc

  2. Instalar BasicTeX: Como o MacTeX é bastante grande, optei pelo pacote menor BasicTeX para economizar espaço. Execute este comando:

    brew install --cask basictex

  3. Instalar Pacotes Comuns do LaTeX: Para garantir que você tenha os pacotes necessários para gerar PDFs, execute estes comandos:

    sudo tlmgr update --self
sudo tlmgr install collection-basic collection-latex collection-latexrecommended collection-fontsrecommended

Passo 2: Prepare Seu Arquivo Markdown

Em seguida, crie seu arquivo Markdown (por exemplo, paper.md). Veja como configurei meu arquivo, incluindo o título, autor, data e informações de contato:

---
title: "Your Paper Title"
subtitle: "Optional Subtitle"
date: \today

author: |
  | Your Name
  | your-email@tanshuai.com
  | www.tanshuai.com
---

# Abstract

Your abstract here.

# Introduction

Your introduction here.

# Methodology

Your methodology here.

# Results

Your results here.

# Conclusion

Your conclusion here.

Passo 3: Converter Markdown para PDF com Pandoc

Agora, você pode converter seu arquivo Markdown em um PDF. Usei o seguinte comando no Terminal:

pandoc paper.md -o paper.pdf --pdf-engine=xelatex

Este comando usa o template LaTeX padrão do Pandoc para converter o arquivo Markdown em um PDF no estilo de artigos acadêmicos, incluindo as informações de contato do autor abaixo do nome.

Dicas Adicionais

  • Template LaTeX Personalizado: Se você precisar de formatação mais avançada ou estilos específicos, pode criar ou baixar um template LaTeX personalizado e usá-lo com o Pandoc:

    pandoc paper.md -o paper.pdf --pdf-engine=xelatex --template=seu-template.tex

  • Mais Metadados: Você pode adicionar informações extras no cabeçalho de metadados YAML, como um resumo ou palavras-chave, e usá-los em templates personalizados.

Conclusão

Seguindo estes passos, você pode facilmente converter documentos Markdown em PDFs no estilo de artigos acadêmicos no macOS. Usar Pandoc e BasicTeX torna esse processo rápido e eficiente, perfeito para quando você precisa gerar documentos PDF profissionais. Seja preparando artigos acadêmicos, relatórios técnicos ou outros documentos formais, este método funciona muito bem. Incluir informações de contato no cabeçalho de metadados adiciona um toque profissional aos seus documentos.

Espero que você ache este guia útil! Se tiver alguma dúvida ou encontrar problemas, sinta-se à vontade para entrar em contato. Boa escrita!