Github-Flavored Markdown'ı PDF'ye Nasıl Dönüştürebilirim?

Son zamanlarda dokümantasyonla kullanım için Markdown'ı öğrenmeye başladım ve birkaç Markdown sayfa yazdırmam gerekiyor. Github-flavored Markdown'ı PDF'ye dönüştürmeme izin veren bir komut satırı, Terminal vb. Yardımcı program kullanmak istiyorum. Doğru sözdizimi vurgulaması gerekir ve korkunç görünmemelidir. Herhangi bir yardım için teşekkürler.

Chrome'da etiketlemeyi göstermek için kavramayı başardım ve ardından Yazdır iletişim kutusundaki Chrome'un "PDF Olarak Kaydet" seçeneğini kullanın.

pip install grip  
grip your_markdown.md

grip, localhost: 5000 'de etiketleme işlevini yerine getirecektir. Hazır olunca yazdırın.

Bu, pandoc'tan daha güvenilir bir sunum sağladı ve lateks kurulumundan daha hafif (pdfoc için pandoc tarafından talep edildi).

Baskı bu cevaptaki komut satırı değildir, ancak yine de bunu daha kolay / daha güvenilir bulmuştur (nispeten bağlantılı görüntüler ve kod vurgulama dahil uzun bir belge için% 100 Github'a benziyordu).

Ayrıca Node.js tabanlı markdown-pdf kullanabilirsiniz.

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

Pandoc'a bir bak . Sözdizimi vurgulama var. Belgenizde kendi markör lezzetine sahip olduğu için belgenizde (küçük) değişiklikler yapmanız gerekebilir ve GitHub lezzetine ne kadar yakın uyduğunu bilmiyorum.

Markdown dosyası github depo barındırılan ise, gitprint pdf / baskı oluşturmak için ilginç bir seçenektir.

Tek yapmanız gereken tek şey değiştirmektir github.comtarafından gitprint.comadressen. Gitprint'in ana sayfasından bir örnek .

Ne yazık ki, markdown markaları üzerinde çalışmaz ve sadece depodaki markdown dosyaları ile çalışır.

Http://www.markdowntopdf.com adresinde mevcut bir çevrimiçi çevirici var.
Bu, kutudan çıkan sözdizimini sağlar ve şu ana kadar gördüğüm en basit çözümdür. Ayrıca, GFM'ye özgü tabloları gibi diğer özellikleri de doğru bir şekilde işler.

Yorumumda belirttiğim gibi, Github sözdizimi vurgulaması için Linguist kullanıyor . Github'da, bunun gibi sözdizimini vurgulamak için bunu kullanabilirsiniz:

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

Ne yazık ki, Markdown'u doğrudan sözdizimi vurgulamasıyla bir PDF dosyasına dönüştürmenin iyi bir yolu yoktur.

Alternatifler:

Vim :

Vim'iniz varsa, aşağıdakileri bir terminalden çalıştırarak sözdizimi vurgulamayı kolayca yapabilirsiniz:

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

Veya vim'in içinde:

:hardcopy >/path/to/file.ps

Bu, örneğin ps2pdf kullanarak pdf'e dönüştürülebilen bir PostScript dosyası üretecektir:

ps2pdf /path/to/file.ps

Kaynak vurgusu :

Bunun yerine HTML veya LaTeX’in rotasına gitmek isterseniz, bunun yerine Source-highlight'ı deneyebilirsiniz . Source-highlight tarafından desteklenen tüm dillerin bir listesini burada bulabilirsiniz .

Birkaç örnek Kaynak-vurgulama komutu şunları içerir:

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

Bu girdi dosyasını kullanma

Ve her biri kendi HTML dosyasını çıkaran:

Hello1.html
Hello2.html
Merhaba3.html

Kaynak vurgusu kullanımına ilişkin diğer örnekleri burada bulabilirsiniz.

Windows :

Vim , ps2pdf ( Ghostscript tarafından sağlanır ) ve Source-highlight özelliklerine Cygwin aracılığıyla erişilebilir .

Linux kullananlar için pandoc kullanın .

Yüklemek:

sudo apt install pandoc texlive-latex-extra

Evet, -extrayazı tipleri nedeniyle pakete ihtiyacınız var .

Dönüştürmek:

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

Geçenlerde markdown belgelerini PDF'ye dönüştürmek için bir hizmet yarattım. Github aromalı etiketlemenin yanı sıra sözdizimi vurgulamayı da destekler. Hizmetin bulunduğu yer: http://markdown2pdf.com

Mine çözüm: ile fiyat indirimlerini dönüştürmek pandochtml (unutma Pandoc için css kullanmak tablo sınırlarını göstermek için) daha sonra ile açın, libreofficebir seçenek belirleyin export as pdf.

Not : burada ve İnternet çözümleri üzerinde hiçbiri benim için çalışmamış: 1) tarayıcı tabanlı çözümler (örneğin, tutma) , fazla bilgi ekliyor, sayfa numaralarını (örneğin , kaldırmayı başaramadım, 2) pandoc'u pdf'ye çevirme kırılmış, benim için boş bir masa oluşturur (belki de unicode yüzünden ve evet, xetex kullanacak şekilde yapılandırdım) , 3) site tabanlı çözümler (yani gitprint.com) ayrıca github benzeri marjlar gibi gereksiz şeyler de ekliyor. Awk ile oluşturduğum basit bir tabloya ihtiyacım var!

Birkaç krom eklentisini ve çevrimiçi dönüştürücüyü denedim.
MDtr2PDF en iyisidir. Github-flavored-markdown ve unicode'u destekler.

Ben rafine bu pasajı benim kişisel ihtiyaçları için:

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

Farklı /usr/local/bin/md2pdfve sudo chmod +x /usr/local/bin/md2pdfsonra kaydedin .

Kullanımı:

• md2pdf README.md dosyasını README.md.pdf dosyasına dönüştürür

• md2pdf foo.md foo.md dosyasını foo.md.pdf dosyasına dönüştürür

• md2pdf foo.md bar.pdf foo.md dosyasını bar.pdf dosyasına dönüştürür