All commit authors signed the Contributor License Agreement.

Most changes to Python require a NEWS entry. Add one using the blurb_it web app or the blurb command-line tool.

If this change has little impact on Python users, wait for a maintainer to apply the skip news label instead.

Quick question but are there other modules with that issue?

I only found pyspecific, but that one is internal.

This is an easy enough fix, but feels like a bug in VS Code.

Have you reported it to VS Code?

There could be other projects also using tildes as underlines, as the tilde is a valid and recommended underline character for sections in reStructuredText:

Specifically, an underline/overline character may be any non-alphanumeric printable 7-bit ASCII character [7].

[7] The following are all valid section title adornment characters:

! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~

Some characters are more suitable than others. The following are recommended:

= - ` : . ' " ~ ^ _ * + #

https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#sections

reStructuredText

I think it's interpreting it as markdown, not RST.

Closing as churn, this should be fixed in VS Code.

A

I only found pyspecific, but that one is internal.

Let's change it in another PR if @AA-Turner wants to.