`ast` module docstring markup renders poorly in Visual Studio Code

# Documentation

## `ast` module docstring renders as
![Image](https://github.com/user-attachments/assets/50a5f86d-4aa6-4561-88b4-9243c31c34d7)

## Due to `~~~`
![Image](https://github.com/user-attachments/assets/76f2f4bd-9c5d-4468-ae63-eba33e42535d)

## Change to `---`
![Image](https://github.com/user-attachments/assets/9a1239db-092b-468c-8726-05bcb6e56480)

## Problems solved
![Image](https://github.com/user-attachments/assets/c75a5205-2877-4d8e-9255-7dd11e585e89)

## Environment(s)

- Windows 11
- Visual Studio Code and Visual Studio Code Insiders
- For me, it has always rendered that way (which is only about five months of using the `ast` module)

## Module on GitHub

https://github.com/python/cpython/blob/614d79231d1e60d31b9452ea2afbc2a7d2f0034b/Lib/ast.py#L1-L26


### Linked PRs
* gh-133047
* gh-133050
* gh-133060

	"""
	ast
	~~~

	The `ast` module helps Python applications to process trees of the Python
	abstract syntax grammar. The abstract syntax itself might change with
	each Python release; this module helps to find out programmatically what
	the current grammar looks like and allows modifications of it.

	An abstract syntax tree can be generated by passing `ast.PyCF_ONLY_AST` as
	a flag to the `compile()` builtin function or by using the `parse()`
	function from this module. The result will be a tree of objects whose
	classes all inherit from `ast.AST`.

	A modified abstract syntax tree can be compiled into a Python code object
	using the built-in `compile()` function.

	Additionally various helper functions are provided that make working with
	the trees simpler. The main intention of the helper functions and this
	module in general is to provide an easy to use interface for libraries
	that work tightly with the python syntax (template engines for example).


	:copyright: Copyright 2008 by Armin Ronacher.
	:license: Python License.
	"""

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

`ast` module docstring markup renders poorly in Visual Studio Code #133046

Documentation

`ast` module docstring renders as

Due to `~~~`

Change to `---`

Problems solved

Environment(s)

Module on GitHub

Linked PRs

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Uh oh!

ast module docstring markup renders poorly in Visual Studio Code #133046

Description

Documentation

ast module docstring renders as

Due to ~~~

Change to ---

Problems solved

Environment(s)

Module on GitHub

Linked PRs

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions

`ast` module docstring markup renders poorly in Visual Studio Code #133046

`ast` module docstring renders as

Due to `~~~`

Change to `---`