{"repo":"executablebooks/rst-to-myst","free":true,"listed":false,"github":"https://github.com/executablebooks/rst-to-myst","clone":"git clone https://github.com/executablebooks/rst-to-myst.git","description":"Convert ReStructuredText to MyST Markdown","language":"Python","stars":73,"topics":["restructuredtext","myst","markdown","sphinx"],"license":"MIT","category":"workflow-automation","readme_excerpt":"rst-to-myst [![Build Status][ci-badge]][ci-link] [![codecov.io][cov-badge]][cov-link] [![PyPI version][pypi-badge]][pypi-link] Convert ReStructuredText to MyST Markdown, and also explore available roles/directives. See tests/fixtures/render.txt for examples of inputs - outputs. Install or with sphinx: To then run a basic conversion of a whole project: For greater control, you can pass configuration with CLI options, or via a YAML configuration file: config.yaml : See the documentation for more information: Development This package utilises flit as the build engine, and tox for test automation. To install these development dependencies: To run the tests: To run the code formatting and style checks: Publish to PyPi Either use flit directly: or trigger the GitHub Action job, by creating a release with a tag equal to the version, e.g. v0.0.1 . Note, this requires generating an API key on PyPi and adding it to the repository Settings/Secrets , under the name PYPI KEY . TODO The conversion covers almost all syntaxes (see ) except: - line blocks - option lists Also custom functions for directive parsing would be desirable. [ci-badge]: https://github.com/executablebooks/rst-to-myst/workflows/CI/badge.svg?branch=main [ci-link]: https://github.com/executablebooks/rst-to-myst/actions?query=workflow%3ACI+branch%3Amain+event%3Apush [cov-badge]: https://codecov.io/gh/executablebooks/rst-to-myst/branch/main/graph/badge.svg [cov-link]: https://codecov.io/gh/executablebooks/rst-to-myst [pypi-","default_branch":null,"files":null,"tree":[],"storefront":"/r/executablebooks","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/executablebooks/rst-to-myst/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}