diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1d500d7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,43 @@
+# NEURON mod files for the K-A current
+
+From the papers:
+Benison et al., *J. Theor. Biol.* 210:187 (2001) (model) and
+Skaliora, et al., *Eur. J. Neurosci.* 7:1558-1568 (1995) (exp.).
+
+Running the **kinetics.hoc** simulation file will show
+the activation and inactivation steady-states, the time constants,
+and a family of curves generated modeling the same protocols
+used for Figs. 8B of the experimental paper.
+
+The kinetic parameters used here are from the modeling paper.
+They were chosen by the authors to fit the time course
+of the current obtained from whole-cell data in their own
+laboratory (experimental paper).
+
+The peak conductance has been adjusted to give approximately the
+same peak currents shown in the experiments.
+
+## Under Unix systems:
+
+To compile the mod files use the command
+`nrnivmodl`
+
+and run the simulation hoc file with the command
+`nrngui kinetics.hoc`
+
+## Under Windows using NEURON 5.1:
+
+To compile the mod files use the **mknrndll** command.
+A double click on the simulation file
+**kinetics.hoc**
+will open the simulation window.
+
+Questions on the model parameters should be directed to the
+authors of the modeling paper.
+
+Questions on how to use this model with NEURON
+should be directed to michele@pa.ibf.cnr.it
+
+---
+
+2025-05-27 – Standardized to Markdown
\ No newline at end of file
diff --git a/readme.txt b/readme.txt
deleted file mode 100644
index 247f4a6..0000000
--- a/readme.txt
+++ /dev/null
@@ -1,34 +0,0 @@
-NEURON mod files for the K-A current from the papers:
-Benison et al., J.Theor.Biol. 210:187 (2001) (model) and
-Skaliora, et al., Eur.J.Neurosci. 7:1558-1568 (1995) (exp.).
-
-Running the kinetics.hoc simulation file will show 
-the activation and inactivation steady-states, the time constants, 
-and a family of curves generated modeling the same protocols 
-used for Figs.8B of the experimental paper.
-
-The kinetic parameters used here are from the modeling paper.
-They where chosen by the authors to fit the time course 
-of the current obtained from whole-cell data in their own 
-laboratory (experimental paper).
-
-The peak conductance has been adjusted to give approximately the
-same peak currents shown in the experiments.
- 
-Under unix systems:
-to compile the mod files use the command 
-nrnivmodl 
-and run the simulation hoc file with the command 
-nrngui kinetics.hoc
-
-Under Windows using NEURON 5.1:
-to compile the mod files use the "mknrndll" command.
-A double click on the simulation file
-kinetics.hoc 
-will open the simulation window.
-
-Questions on the model parameters should be directed to the 
-authors of the modeling paper.
-
-Questions on how to use this model with NEURON
-should be directed to michele@pa.ibf.cnr.it