Release notes do not have headers

[germa89]

As the title.

In the Github release notes, this is the output:

# [0.70.1](https://github.com/ansys/pymapdl/releases/tag/v0.70.1) - May 12, 2025

Added

<table>
<tbody>
<tr>
<td>chore: update version to 0.70.dev0 in pyproject.toml</td>
<td><a href="https://github.com/ansys/pymapdl/pull/3907">#3907</a></td>
</tr>
<tr>
<td>chore: update CHANGELOG for v0.70.0</td>
<td><a href="https://github.com/ansys/pymapdl/pull/3913">#3913</a></td>
</tr>
</tbody>
</table>

Fixed

<table>
<tbody>
<tr>
<td>fix: Change the mapdl<span id="inprocess">inprocess</span> graphics
backend</td>
<td><a href="https://github.com/ansys/pymapdl/pull/3915">#3915</a></td>
</tr>
<tr>
<td>fix: documentation html looks</td>
<td><a href="https://github.com/ansys/pymapdl/pull/3918">#3918</a></td>
</tr>
</tbody>
</table>

Where in the changelog file, we have a very nice formatted table: https://mapdl.docs.pyansys.com/version/stable/changelog.html#may-12-2025

I think we should have headers like:

# [0.70.1](https://github.com/ansys/pymapdl/releases/tag/v0.70.1) - May 12, 2025

## Added

<table>
<tbody>
<tr>
<td>chore: update version to 0.70.dev0 in pyproject.toml</td>
<td><a href="https://github.com/ansys/pymapdl/pull/3907">#3907</a></td>
</tr>
<tr>
<td>chore: update CHANGELOG for v0.70.0</td>
<td><a href="https://github.com/ansys/pymapdl/pull/3913">#3913</a></td>
</tr>
</tbody>
</table>

## Fixed

<table>
<tbody>
<tr>
<td>fix: Change the mapdl<span id="inprocess">inprocess</span> graphics
backend</td>
<td><a href="https://github.com/ansys/pymapdl/pull/3915">#3915</a></td>
</tr>
<tr>
<td>fix: documentation html looks</td>
<td><a href="https://github.com/ansys/pymapdl/pull/3918">#3918</a></td>
</tr>
</tbody>
</table>

Not sure what is the best approach.

[germa89]

PD. I also see that having the hyperlink pointing towards the date can be problematic (changelog.html#may-12-2025 vs changelog.html#0.70.1)

[germa89]

The problem seems to be at parsing the rST table to markdown. Pandoc strip all the table info and leave it just a list of bullet points.

I would probably start by using Github markdown gfm in:

actions/python-utils/release_github_utils.py

Line 108 in cfd37c3

body = pypandoc.convert_text(body, "markdown_strict", format="rst")

[germa89]

The problem seems to be at parsing the rST table to markdown. Pandoc strip all the table info and leave it just a list of bullet points.

I would probably start by using Github markdown gfm in:

actions/python-utils/release_github_utils.py

Line 108 in cfd37c3

body = pypandoc.convert_text(body, "markdown_strict", format="rst")

It doesn't look good enough:

---

Added

chore: update version to 0.70.dev0 in pyproject.toml	#3907
chore: update CHANGELOG for v0.70.0	#3913

Fixed

fix: Change the mapdl_inprocess graphics backend	#3915
fix: documentation html looks	#3918

Dependencies

build: bump the core group with 2 updates	#3910
build: bump the testing group with 2 updates	#3911

Maintenance

feat: add artifact upload steps for JSONL logs in local and remote test workflows	#3905
build: bump platformdirs from 4.3.7 to 4.3.8 in the minimal group	#3909
build: update action versions in CI workflows to latest stable releases	#3920

[germa89]

Probably we will have to play with the RST file which is not nice.