[girinataraj]

Description

Automatic links currently recognize only HTTP and FTP schemes. Other schemes
are emitted as raw markup, or incorrectly matched as email addresses when the
URL contains user information. For example:

<!-- Before -->
<p><ssh://example.org></p>
<p><a href="mailto:ssh://user@example.org/path">ssh://user@example.org/path</a></p>
<!-- After -->
<p><a href="ssh://example.org">ssh://example.org</a></p>
<p><a href="ssh://user@example.org/path">ssh://user@example.org/path</a></p>

The before example above decodes the HTML entities used to obfuscate email
addresses for readability.

Replace the hard-coded scheme alternatives with a letter-led scheme pattern,
allowing letters, digits, +, . and - after the first character. Keep the
existing :// delimiter, destination matching and link renderer. This follows
the URL expansion discussed in #1244; raw HTML handling and URI forms without
://, such as <urn:foo>, remain unchanged.

Add tests for SSH and Git URLs with user information, scheme variants,
query-string escaping, link boundaries and code spans. Update the syntax
documentation and add an unreleased changelog entry under Added.

Fixes #1244.

Validation on Windows, CPython 3.12.14:

• Focused autolink, link and raw HTML tests: 57 passed. The new user-information
  regression fails for both cases when run with the upstream pattern.
• Full suite: 1,144 tests run, 111 skipped, no failures or errors. The optional
  HTML Tidy and pinned Pygments environments were not exercised.
• Changed Python files pass Flake8. Repository-wide Flake8 7.2.0 reports four
  pre-existing E201/E202 errors in the untouched markdown/postprocessors.py:90.

Other Python versions and documentation/link/spelling builds were not run.

AI Assistance Disclosure

• No AI tools were used in preparing this PR.

• AI tools were used and I have disclosed which ones, and have fully reviewed and verified their output.

  OpenAI Codex assisted with issue research, reproduction, implementation,
  tests, documentation, changelog, commit message and this PR description.
  A Codex sub-agent reviewed the local patch; no automated AI review has
  been requested on this upstream PR.

  AI tools were used to assist with the following:

  • Code
  • Code Comments
  • Documentation
  • Changelog Entry
  • Commit Message
  • The Description Above
  • Other: regression tests and local patch review

Checklist

• This PR follows the contribution guidelines.
• The code follows the Code Style Guide.
• The commit message follows the Commit Message Style Guide.
• I have added or updated relevant docs, including release notes if applicable which follow the Documentation Style Guide.
• I have added or updated relevant tests.
• I have not requested, and will not request, an automated AI review for this PR.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

[waylan]

After reviewing the discussion in #1244 I can see you provided the fix I suggested. I am not yet convinced this is the best approach. I will have to think about it.

[girinataraj]

Understood. I’m happy to revise the implementation if you decide a different approach would fit the project better.

[girinataraj]

One more conservative option would be to preserve the existing HTTP/FTP matching and require a nonempty destination without whitespace for additional schemes. The current patch also recognizes <ssh://> and <ssh://example.org/a b> because it retains the existing destination pattern.

Would that address your concern, or are you reconsidering broader scheme recognition in the default parser?