DeepLcom / deepl-python

Official Python library for the DeepL language translation API.
https://www.deepl.com
MIT License
1.12k stars 80 forks source link

Translation of Markdown (MD) files #36

Open tderflinger opened 2 years ago

tderflinger commented 2 years ago

Hi DeepL,

your Python library is great. Since I am using your library to translate some of my articles of my blog, I would like to inform you of some issues. My articles are in the markdown format (. md). When I translate markdown files I often encounter that DeepL does not preserve the formatting. Sometimes, parts of the sentence are repeated in the target language (I suppose because of a new line in the original document). I tried different settings in the Python library but none got it completely right.

Therefore, I would like to ask you to look into making translation of markdown documents better. I am sure this problem also encounter other people, and especially for technical programming documents and websites, markdown is often used. These clients would also benefit hugely from your improvements.

BTW: GitHub has a spec of their own flavor of markdown here: https://github.github.com/gfm/

Thanks! :)

daniel-jones-deepl commented 2 years ago

Hi Thomas, thank you for the feedback.

Our translation software does not currently support translating Markdown. Our translation models might sometimes preserve the correct formatting, but it is not fully reliable.

We’ve had requests for Markdown translation from other users too, and it is something we want to look into. As a first step we could publish example code to translate Markdown files on the client side.

I’ll let you know when I have an update in future.