diff --git a/MANIFEST.in b/MANIFEST.in
index f3b312ec..3864ad3f 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,3 +1,3 @@
-include README.rst
+include README.md
include LICENSE.txt
include iodata/test/data/*.*
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..cd402093
--- /dev/null
+++ b/README.md
@@ -0,0 +1,52 @@
+# IOData
+
+[](https://github.com/theochem/iodata/actions/workflows/pytest.yaml)
+[](https://github.com/theochem/iodata/actions/workflows/release.yaml)
+[](https://github.com/theochem/iodata/actions/workflows/sphinx.yaml)
+[](https://www.codefactor.io/repository/github/theochem/iodata)
+[](https://app.deepsource.com/gh/theochem/iodata/)
+[](https://app.deepsource.com/gh/theochem/iodata/)
+[](https://pypi.python.org/pypi/qc-iodata/)
+
+
+
+## About
+
+IOData is a HORTON 3 module for input/output of quantum chemistry file
+formats. Documentation is here: or
+
+
+## Citation
+
+Please use the following citation in any publication using IOData
+library:
+
+> **\"IOData: A python library for reading, writing, and converting
+> computational chemistry file formats and generating input files.\"**,
+> T. Verstraelen, W. Adams, L. Pujal, A. Tehrani, B. D. Kelly,
+> L. Macaya, F. Meng, M. Richer, R. Hernandez‐Esparza, X. D. Yang, M. Chan,
+> T. D. Kim, M. Cools‐Ceuppens, V. Chuiko, E. Vohringer‐Martinez,
+> P. W. Ayers, F. Heidar‐Zadeh,
+> [J Comput. Chem. 2021, 42(6), 458--464](https://doi.org/10.1002/jcc.26468).
+
+## Installation
+
+In anticipation of the 1.0 release of IOData, install the latest
+pre-release as follows:
+
+```bash
+python -m pip install qc-iodata
+```
+
+Note that there may still be a few API changes between the pre-release
+1.0.0a4 and the upcoming stable release 1.0.0.
+
+See for full details.
+
+## Contributing
+
+We welcome contributions of all kinds, such as new features,
+improvements, bug fixes, and documentation clarifications. Please read
+our [Contributor Guide](https://iodata.qcdevs.org/contributing.html) and
+[Code of Conduct](https://github.com/theochem/.github/blob/main/CODE_OF_CONDUCT.md)
+for more details.
diff --git a/README.rst b/README.rst
deleted file mode 100644
index 0e6a5981..00000000
--- a/README.rst
+++ /dev/null
@@ -1,87 +0,0 @@
-..
- : IODATA is an input and output module for quantum chemistry.
- :
- : Copyright (C) 2011-2019 The IODATA Development Team
- :
- : This file is part of IODATA.
- :
- : IODATA is free software; you can redistribute it and/or
- : modify it under the terms of the GNU General Public License
- : as published by the Free Software Foundation; either version 3
- : of the License, or (at your option) any later version.
- :
- : IODATA is distributed in the hope that it will be useful,
- : but WITHOUT ANY WARRANTY; without even the implied warranty of
- : MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- : GNU General Public License for more details.
- :
- : You should have received a copy of the GNU General Public License
- : along with this program; if not, see
- :
- : --
-
-IOData
-======
-|pytest|
-|release|
-|CodeFactor|
-|PyPI|
-|Version|
-|License|
-
-
-About
------
-
-IOData is a HORTON 3 module for input/output of quantum chemistry file formats.
-Documentation is here: https://iodata.readthedocs.io/ or https://iodata.qcdevs.org/
-
-
-Citation
---------
-
-Please use the following citation in any publication using IOData library:
-
- **"IOData: A python library for reading, writing, and converting computational chemistry file
- formats and generating input files."**, T. Verstraelen, W. Adams, L. Pujal, A. Tehrani, B. D.
- Kelly, L. Macaya, F. Meng, M. Richer, R. Hernandez‐Esparza, X. D. Yang, M. Chan, T. D. Kim, M.
- Cools‐Ceuppens, V. Chuiko, E. Vohringer‐Martinez,P. W. Ayers, F. Heidar‐Zadeh,
- `J Comput Chem. 2021; 42: 458– 464 `__.
-
-
-Installation
-------------
-
-In anticipation of the 1.0 release of IOData, install the latest pre-release as follows:
-
-.. code-block:: bash
-
- python -m pip install qc-iodata
-
-Note that there may still be a few API changes between the pre-release 1.0.0a3
-and the upcoming stable release 1.0.0.
-
-See https://iodata.readthedocs.io/en/latest/install.html for full details.
-
-
-Contributing
-------------
-
-We welcome contributions of all kinds,
-such as new features, improvements, bug fixes, and documentation clarifications.
-Please read our `Contributor Guide`_ and `Code of Conduct`_ for more details.
-
-
-.. |pytest| image:: https://github.com/theochem/iodata/actions/workflows/pytest.yaml/badge.svg
- :target: https://github.com/theochem/iodata/actions/workflows/pytest.yaml
-.. |release| image:: https://github.com/theochem/iodata/actions/workflows/release.yaml/badge.svg
- :target: https://github.com/theochem/iodata/actions/workflows/release.yaml
-.. |CodeFactor| image:: https://www.codefactor.io/repository/github/tovrstra/stepup-core/badge
- :target: https://www.codefactor.io/repository/github/tovrstra/stepup-core
-.. |Version| image:: https://img.shields.io/pypi/pyversions/qc-iodata.svg
-.. |License| image:: https://img.shields.io/github/license/theochem/iodata
-.. |PyPI| image:: https://img.shields.io/pypi/v/qc-iodata.svg
- :target: https://pypi.python.org/pypi/qc-iodata/
-.. _virtual environment: https://docs.python.org/3/tutorial/venv.html
-.. _Contributor Guide: https://iodata.qcdevs.org/contributing.html
-.. _Code of Conduct: https://github.com/theochem/.github/blob/main/CODE_OF_CONDUCT.md
diff --git a/pyproject.toml b/pyproject.toml
index 184ddbea..af790630 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -8,7 +8,7 @@ authors = [
{ name="HORTON-ChemTools Dev Team", email="horton.chemtools@gmail.com" },
]
description = "Python Input and Output Library for Quantum Chemistry"
-readme = "README.rst"
+readme = "README.md"
license = {file = "LICENSE.txt"}
requires-python = ">=3.9"
classifiers = [