Jak przekonwertować Markdown o smaku Github na plik PDF

Niedawno zacząłem uczyć się Markdown do użytku z dokumentacją i muszę wydrukować kilka moich stron Markdown. Chciałbym użyć narzędzia wiersza polecenia, terminala itp., Które pozwala mi przekonwertować Markdown o smaku Github na PDF. Musi mieć odpowiednie podświetlanie składni i nie powinien wyglądać okropnie. Dziękuję za wszelką pomoc.

Odniosłem sukces, używając uchwytu do wyświetlania znaczników w przeglądarce Chrome, a następnie skorzystałem z opcji Chrome „Zapisz jako PDF” w oknie dialogowym Drukuj.

pip install grip  
grip your_markdown.md

grip wyświetli przecenę na localhost: 5000 - po prostu edytuj i odśwież przeglądarkę. Drukuj, gdy będzie gotowy.

Dało to bardziej niezawodną reprezentację niż pandoc i było lżejsze niż instalacja lateksu (wymagana przez pandoc do generowania pdf).

Wydruk nie jest wierszem polecenia w tej odpowiedzi, ale nadal jest łatwiejszy / bardziej niezawodny (wyglądał w 100% jak Github w przypadku długiego dokumentu zawierającego względnie połączone obrazy i wyróżnianie kodu).

Możesz także użyć opartego na Node.js markdown-pdf

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

Spójrz na pandoc . Ma podświetlanie składni. Może to wymagać wprowadzenia (drobnych) zmian w dokumencie, ponieważ ma on swój własny styl markdown i nie wiem, jak ściśle pasuje do smaku GitHub.

Jeśli plik przeceny był przechowywany w repozytorium github, gitprint jest interesującą opcją do utworzenia pdf / print.

Wszystko, co musisz zrobić, to wymienić github.comby gitprint.comw adresie URL. Oto przykład ze strony głównej gitprint.

Niestety, nie działa on na listach Markdown i działa tylko z plikami Markdown w repozytorium.

Dostępny jest internetowy konwerter dostępny pod adresem http://www.markdowntopdf.com.
Zapewnia to podświetlanie składni po wyjęciu z pudełka i jest najprostszym rozwiązaniem, jakie do tej pory widziałem. Prawidłowo obsługuje także inne funkcje charakterystyczne dla GFM, np. Tabele.

Jak stwierdziłem w moim komentarzu, Github używa Linguist do podświetlania składni. W Github możesz użyć tego do określenia podświetlania składni w następujący sposób:

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

Niestety nie ma dobrego sposobu na konwersję Markdown bezpośrednio do pliku PDF z podświetlaniem składni.

Alternatywy:

Vim :

Jeśli masz vima, możesz łatwo osiągnąć wyróżnianie składni, uruchamiając następujące polecenie z terminala:

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

Lub w vimie:

:hardcopy >/path/to/file.ps

Spowoduje to utworzenie pliku PostScript, który można przekonwertować na format pdf, na przykład ps2pdf:

ps2pdf /path/to/file.ps

Podświetlenie źródła :

Jeśli zamiast tego chcesz przejść drogą HTML lub LaTeX, możesz zamiast tego spróbować Source-highlight . Listę wszystkich języków obsługiwanych przez podświetlanie źródła można znaleźć tutaj .

Kilka przykładowych poleceń podświetlania źródła obejmuje:

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

Korzystanie z tego pliku wejściowego

Każdy z nich wyprowadza własny plik HTML:

Hello1.html
Hello2.html
Hello3.html

Dalsze przykłady użycia podświetlenia źródła można znaleźć tutaj

Windows :

Vim , ps2pdf (dostarczone przez Ghostscript ) i Source-highlight są dostępne za pośrednictwem Cygwin .

W przypadku Linuksa użyj pandoc .

Zainstalować:

sudo apt install pandoc texlive-latex-extra

Tak, potrzebujesz -extrapaczki z powodu czcionek.

Konwertować:

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

Niedawno utworzyłem usługę do konwersji dokumentów przecenionych do formatu PDF. Obsługuje markdown o smaku Github, a także podświetlanie składni. Usługa znajduje się na stronie: http://markdown2pdf.com

Moje rozwiązanie: przekonwertuj markdown pandocna html (nie zapomnij użyć css dla pandoc, aby wyświetlić obramowania tabeli) , a następnie otwórz go za pomocą libreoffice, wybierz opcję export as pdf.

Uwaga : żadne z wymienionych tutaj i w Internecie rozwiązań nie działało dla mnie: 1) rozwiązania przeglądarkowe (tj. Grip) dodają nadmiar informacji, takich jak numery stron, których nie udało mi się usunąć, 2) konwersja pandoc do pdf jest zepsuty, dla mnie generuje pustą tabelę (być może z powodu Unicode, i tak, skonfigurowałem ją do używania xetex) , 3) rozwiązania oparte na witrynie (np. gitprint.com) również dodają zbędne elementy, takie jak marginesy podobne do github, podczas gdy Potrzebuję tylko prostej tabeli wygenerowanej przez awk!

Wypróbowałem kilka wtyczek chrome i konwerterów online.
MDtr2PDF jest najlepszy. Obsługuje markdown o smaku Github i Unicode.

Udoskonaliłem ten fragment dla moich osobistych potrzeb:

# 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}')

Zapisz jako /usr/local/bin/md2pdfi sudo chmod +x /usr/local/bin/md2pdfpóźniej.

Stosowanie:

• md2pdf konwertuje README.md na README.md.pdf

• md2pdf foo.md konwertuje foo.md na foo.md.pdf

• md2pdf foo.md bar.pdf konwertuje foo.md na bar.pdf