Como posso converter um Markdown com sabor do Github em um PDF

Recentemente, comecei a aprender o Markdown para uso com a documentação e preciso imprimir algumas das minhas páginas do Markdown. Gostaria de usar um utilitário de linha de comando, Terminal etc. que me permita converter Markdown com sabor do Github em PDF. Ele precisa ter destaque apropriado da sintaxe e não deve parecer horrível. Obrigado por qualquer ajuda.

Consegui usar a aderência para exibir descontos no Chrome e usar a opção "Salvar como PDF" do Chrome na caixa de diálogo Imprimir.

pip install grip  
grip your_markdown.md

grip renderizará a redução no localhost: 5000 - basta editar e atualizar o navegador. Imprima quando estiver pronto.

Isso deu uma representação mais confiável que o pandoc e foi mais leve que a instalação do látex (exigido pelo pandoc para geração de pdf).

A impressão não é uma linha de comando nesta resposta, mas ainda assim foi mais fácil / confiável (parecia 100% parecido com o Github em um documento longo, incluindo imagens relativamente vinculadas e destaque de código).

Você também pode usar o markdown-pdf baseado em Node.js.

npm install -g markdown-pdf
markdown-pdf /path/to/markdown

Dê uma olhada no pandoc . Possui destaque de sintaxe. Pode ser necessário que você faça (pequenas) alterações em seu documento, pois ele possui seu próprio sabor de remarcação e não sei se ele se aproxima do sabor do GitHub.

Se o arquivo de marcação estava hospedado no repositório do github, o gitprint é uma opção interessante para criar pdf / print.

Tudo que você precisa fazer é substituir github.compor gitprint.comno URL. Aqui está um exemplo da página inicial do gitprint.

Infelizmente, ele não funciona em listas de descontos e funciona apenas com arquivos de descontos no repositório.

Existe um conversor on-line disponível em http://www.markdowntopdf.com.
Isso fornece destaque de sintaxe imediato e é a solução mais simples que eu já vi até agora. Ele também lida corretamente com outros recursos específicos do GFM, como tabelas.

Como afirmei no meu comentário, o Github usa o Linguist para fornecer destaque de sintaxe. No Github, você pode usar isso para especificar o destaque da sintaxe da seguinte forma:

```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```

Infelizmente, não há uma boa maneira de converter o Markdown diretamente em um arquivo PDF com destaque de sintaxe.

Alternativas:

Vim :

Se você possui o vim, pode obter facilmente o destaque da sintaxe executando o seguinte em um terminal:

vim -c hardcopy -c quit /path/to/file.ps

Ou dentro do vim:

:hardcopy >/path/to/file.ps

Isso produzirá um arquivo PostScript que pode ser convertido em pdf usando, por exemplo, ps2pdf:

ps2pdf /path/to/file.ps

Destaque da fonte :

Se você preferir seguir a rota do HTML ou do LaTeX, tente o Source-realce . Uma lista de todos os idiomas suportados pelo destaque da fonte pode ser encontrada aqui .

Alguns exemplos de comandos de destaque da fonte incluem:

source-highlight -s java -f html -i Hello.java -o Hello1.html
source-highlight -s java -f html --input Hello.java --output Hello2.html --doc
source-highlight -s java -f html -i Hello.java -o Hello3.html --title "Happy Java with java2html :-)" --tab 3

Usando este arquivo de entrada

E cada um emitindo seu próprio arquivo HTML:

Hello1.html
Hello2.html
Hello3.html

Outros exemplos de uso de destaque da fonte podem ser encontrados aqui

Windows :

Vim , ps2pdf (fornecido pelo Ghostscript ) e Source-realce estão disponíveis no Cygwin .

Para aqueles com Linux, use pandoc .

Instalar:

sudo apt install pandoc texlive-latex-extra

Sim, você precisa do -extrapacote por causa das fontes.

Converter:

pandoc --from markdown -o output.pdf my-file.md

Recentemente, criei um serviço para converter documentos de remarcação para PDF. Ele suporta marcações com sabor do Github, bem como realce de sintaxe. O serviço está localizado em: http://markdown2pdf.com

Solução mine: converta markdown com pandocpara html (não se esqueça de usar css para pandoc para mostrar bordas da tabela) e abra-o com libreoffice, escolha uma opção export as pdf.

NB : nenhuma das soluções mencionadas aqui e na Internet funcionou para mim: 1) as soluções baseadas em navegador (ou seja, grip) estão adicionando informações em excesso, como números de páginas, que não consegui remover; 2) a conversão pandoc para pdf é quebrado, para mim gera uma tabela vazia (talvez por causa do unicode, e sim, eu a configurei para usar xetex) , 3) soluções baseadas em site (por exemplo, gitprint.com) também estão adicionando coisas redundantes, como margens semelhantes ao github, enquanto Eu preciso apenas de uma tabela simples que eu criei com o awk!

Eu tentei vários plugins chrome e conversores online.
MDtr2PDF é o melhor. Ele suporta marcações e unicode com sabor do Github.

Refinei este trecho para minhas necessidades pessoais:

# sudo apt install grip wkhtmltopdf

MD=${1:-README.md}
PDF=${2:-"$MD".pdf}
PORT=8971
DELAY=10

printf "Converting $MD to $PDF on port $PORT\n"
printf "Waiting $DELAY seconds for server to start...\n"

grip "$MD" localhost:$PORT &
sleep $DELAY
wkhtmltopdf http://localhost:$PORT "$PDF"
kill $(ps -eo pid,command | grep grip | grep -v grep | awk '{print $1}')

Salve como /usr/local/bin/md2pdfe sudo chmod +x /usr/local/bin/md2pdfdepois.

Uso:

• md2pdf converte README.md em README.md.pdf

• md2pdf foo.md converte foo.md em foo.md.pdf

• md2pdf foo.md bar.pdf converte foo.md em bar.pdf