Alir3z4 / Alir3z4/html2text

Ampersand in link causes different markdown to be generated vs. non-ampersand link

Open
#441 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
2.2k
Forks
296
PR merge metrics
No merged PRs in 30d

Description

Version: `html2text==2025.4.15`.

I want to rely on the behavior where `http://link/` gets rendered in Markdown as ``.

Unfortunately if the link contains an ampersand it renders using `[link](link)`, despite the link and text being exactly the same:

```python
>>> from html2text import HTML2Text as H
>>> h = H()

# good!
>>> h.handle('https://foo/')
'\n\n'

# an ampersand in the URL causes []() link syntax, but I guess that's expected since "&y" turns into "&y;"
>>> h.handle('https://foo/?x=1&y=2')
'[https://foo/?x=1&y;=2](https://foo/?x=1&y=2)\n\n'

# but even when & is escaped, and both link and text end up being exactly the same string, []() is still generated for the link
>>> h.handle('https://foo/?x=1&y=2')
'[https://foo/?x=1&y=2](https://foo/?x=1&y=2)\n\n'
```

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.