Як я можу перетворити відмітку з ароматом Github у PDF

Нещодавно я почав вивчати Markdown для використання з документацією, і мені потрібно роздрукувати кілька моїх сторінок Markdown. Я хотів би скористатися утилітою командного рядка, терміналу тощо, яка дозволяє мені конвертувати Markdown із ароматом Github у PDF. Він повинен мати належне виділення синтаксису і не повинен виглядати жахливо. Дякуємо за будь-яку допомогу.

У мене було успіхом використання grip для відображення розмітки в Chrome, а потім використання параметра Chrome "Зберегти як PDF" у діалоговому вікні "Друк".

pip install grip  
grip your_markdown.md

grip виведе розмітку на localhost: 5000 - просто відредагуйте та оновіть браузер. Роздрукуйте, коли буде готово.

Це дало більш надійне уявлення, ніж pandoc, і було легше, ніж установка латексу (необхідне pandoc для генерації pdf).

Друк не є командним рядком у цій відповіді, але все ж вважав це простішим / надійнішим (виглядав на 100% як Github для довгого документа, включаючи відносно пов’язані зображення та виділення коду).

Ви також можете використовувати позначку-pdf на базі Node.js

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

Погляньте на пандок . У ньому є виділення синтаксису. Можливо, вам знадобиться внести (незначні) зміни в документ, оскільки він має свій аромат розмітки, і я не знаю, наскільки він відповідає аромату GitHub.

Якщо файл розмітки розміщувався у сховищі github, gitprint - це цікавий варіант для створення pdf / print.

Все , що вам потрібно зробити , це замінити github.comна gitprint.comв URL. Ось приклад з домашньої сторінки gitprint.

На жаль, він не працює на нотах розмітки, і працює лише з файлами розмітки в сховищі.

На веб-сайті http://www.markdowntopdf.com доступний онлайн-конвертер.
Це забезпечує виділення синтаксису поза коробкою і є найпростішим рішенням, яке я бачив досі. Він також правильно обробляє інші функції, характерні для GFM, наприклад таблиці.

Як я зазначив у своєму коментарі, Github використовує Linguist для виділення синтаксису. У Github ви можете використовувати це для визначення виділення синтаксису так:

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

На жаль, не існує хорошого способу перетворення Markdown безпосередньо у PDF-файл із підсвічуванням синтаксису.

Альтернативи:

Vim :

Якщо у вас vim, ви можете легко досягти підсвічування синтаксису, виконавши наступне з терміналу:

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

Або всередині vim:

:hardcopy >/path/to/file.ps

Це створить файл PostScript, який можна перетворити в pdf, використовуючи, наприклад, ps2pdf:

ps2pdf /path/to/file.ps

Виділення джерела :

Якщо ви хочете замість цього пройти маршрут HTML або LaTeX, ви можете спробувати Source-виділити натомість. Список усіх мов, що підтримуються джерелом, можна знайти тут .

Кілька прикладів команд для виділення джерела включають:

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

Використовуючи цей вхідний файл

І кожен виводить свій власний HTML-файл:

Hello1.html
Hello2.html
Hello3.html

Подальші приклади використання підсвічування джерела можна знайти тут

Windows :

Vim , ps2pdf (надається Ghostscript ) та Source-виділення доступні через Cygwin .

Для тих, хто має Linux, використовуйте pandoc .

Встановити:

sudo apt install pandoc texlive-latex-extra

Так, вам потрібен -extraпакет через шрифти.

Перетворити:

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

Нещодавно я створив службу для перетворення документів розмітки в PDF. Він підтримує ароматну відмітку Github, а також виділення синтаксису. Служба розміщена за адресою: http://markdown2pdf.com

Шахтне рішення: конвертуйте розмітку з pandocу html (не забудьте використовувати css для pandoc для показу меж таблиці) , а потім відкрийте її libreoffice, виберіть опцію export as pdf.

Примітка : жодне з згаданих тут і в Інтернеті не працювало на мене: 1) рішення на базі браузера (тобто зчеплення) додають зайву інформацію, наприклад номери сторінок, які мені не вдалося видалити; 2) конвертація pandoc у pdf є зламано, для мене він створює порожню таблицю (можливо, через unicode, і так, я налаштував її на використання xetex) , 3) рішення на базі сайту (тобто gitprint.com) також додають зайві речі, наприклад, запаси , схожі на github, тоді як Мені потрібна просто проста таблиця, яку я створив awk!

Я спробував кілька хромованих плагінів та онлайн-перетворювачів.
MDtr2PDF - найкращий. Він підтримує Github-ароматизовану розмітку та unicode.

Я вдосконалив цей фрагмент для моїх особистих потреб:

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

Збережіть як /usr/local/bin/md2pdfі sudo chmod +x /usr/local/bin/md2pdfпізніше.

Використання:

• md2pdf перетворює README.md в README.md.pdf

• md2pdf foo.md перетворює foo.md у foo.md.pdf

• md2pdf foo.md bar.pdf перетворює foo.md в bar.pdf