Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Better conversion of Markdown to PDF #585

Open
binkley opened this issue Jul 17, 2024 · 0 comments
Open

Better conversion of Markdown to PDF #585

binkley opened this issue Jul 17, 2024 · 0 comments
Labels
enhancement New feature or request

Comments

@binkley
Copy link
Owner

binkley commented Jul 17, 2024

The fast solution to #573 is pandoc, however it relies on the LaTeX toolchain to convert Markdown to PDF, and has limitation.

An alternative approach is other tooling such as https://github.com/phseiff/github-flavored-markdown-to-html.

Example issues:

  • No embedded images in the PDF, even when the image files are local to a Markdown file.
  • No support for GitHub-style internal links (ie, [[Example page link]]).
  • Missing UNICODE characters when LaTeX's default font does not support them (such as 🟢).
    This affects 6 files.

Tech context

(copied from #573)

Note that some UNICODE characters (such as 🟢) do not convert, but the Markdown still converts to PDF.
This affects 6 files.
The underlying issue is with the toolchain used to convert: PDF and Markdown support these just fine.
For PDF it relies on the LaTeX toolchain, and use XeLaTeX to ignore issues with UNICODE.
We need to play with the fonts that LaTeX uses, and find options that both look good, and have the missing characters (the default font is "lmroman10-regular").

@binkley binkley added the enhancement New feature or request label Jul 17, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
Status: No status
Development

No branches or pull requests

1 participant