docs(website): add conversion to pdf to tips-and-tricks (#889)

* docs: add conversion to pdf to tips-and-tricks * Update website/docs/tips-and-tricks.md * Update website/docs/tips-and-tricks.md --------- Co-authored-by: Orhun Parmaksız <[email protected]>
orhun · Sep 27, 2024 · 58dc108 · 58dc108
1 parent dfe4459
commit 58dc108
Showing 1 changed file with 12 additions and 0 deletions.
diff --git a/website/docs/tips-and-tricks.md b/website/docs/tips-and-tricks.md
@@ -90,3 +90,15 @@ commit_parsers = [
 ```jinja2
 {{ get_env(name="CI_PROJECT_URL") }}/-/tags/{{ version }}
 ```
+
+## Convert markdown output to PDF
+
+```bash
+pandoc --from=gfm --to=pdf -o CHANGELOG.pdf CHANGELOG.md
+```
+
+To support unicode characters, use `xelatex` as PDF engine and a font family which includes the needed unicode characters:
+
+```bash
+pandoc --from=gfm --to=pdf --pdf-engine=xelatex -o CHANGELOG.pdf CHANGELOG.md --variable mainfont="Segoe UI Emoji"
+```