diff --git a/docs/src/executable.md b/docs/src/executable.md
index d9f1777555..b82003127c 100644
--- a/docs/src/executable.md
+++ b/docs/src/executable.md
@@ -1,4 +1,4 @@
-# Executable
+# [Executable](@id executable)
 
 For convenience, the executable is assumed to be `bin/highs`.
 
diff --git a/docs/src/index.md b/docs/src/index.md
index 54af09ff19..2e0e65a03b 100644
--- a/docs/src/index.md
+++ b/docs/src/index.md
@@ -39,7 +39,7 @@ Get started by following [Install HiGHS](@ref).
 
 ## Overview
 
-The standalone [Executable](@ref) allows models to be solved from
+The standalone [executable](@ref executable) allows models to be solved from
 [MPS](https://en.wikipedia.org/wiki/MPS_(format)) or (CPLEX)
 [LP](https://web.mit.edu/lpsolve/doc/CPLEX-format.htm) files, with full control
 of the HiGHS run-time options, and the solution can be written to files in human
diff --git a/docs/src/options/definitions.md b/docs/src/options/definitions.md
index 2505c4d3c3..31a0eb128d 100644
--- a/docs/src/options/definitions.md
+++ b/docs/src/options/definitions.md
@@ -5,7 +5,7 @@
 - Type: string
 - Default: "choose"
 
-## solver
+## [solver](@id option-solver)
 - Solver option: "simplex", "choose", "ipm" or "pdlp". If "simplex"/"ipm"/"pdlp" is chosen then, for a MIP (QP) the integrality constraint (quadratic term) will be ignored
 - Type: string
 - Default: "choose"
@@ -109,7 +109,7 @@
 - Range: {-2147483647, 2147483647}
 - Default: 0
 
-## simplex\_strategy
+## [simplex\_strategy](@id option-simplex_strategy)
 - Strategy for simplex solver 0 => Choose; 1 => Dual (serial); 2 => Dual (PAMI); 3 => Dual (SIP); 4 => Primal
 - Type: integer
 - Range: {0, 4}
diff --git a/docs/src/options/intro.md b/docs/src/options/intro.md
index ff33cae234..81f0e64246 100644
--- a/docs/src/options/intro.md
+++ b/docs/src/options/intro.md
@@ -3,12 +3,12 @@
 The options that control HiGHS are of four types: `boolean`, `integer`, `double`
 and `string`. Their values can be specified:
 
- * via the command line when running the [Executable](@ref)
+ * via the command line when running the [Executable](@ref executable)
  * via method calls when running HiGHS in an application.
 
 ## Options file
 
-When running the [Executable](@ref) via the command line, some options values
+When running the [Executable](@ref executable) via the command line, some options values
 can be set explicitly in the command, and all options can be set by means of an
 options file.
 
diff --git a/docs/src/parallel.md b/docs/src/parallel.md
index 3a857629e3..016834ab98 100644
--- a/docs/src/parallel.md
+++ b/docs/src/parallel.md
@@ -20,7 +20,7 @@ has a variant allowing concurrent processing. This variant is used
 when the
 [parallel](@ref)
 option is set "on", by specifying `--parallel` when running the
-[executable](@ref Executable) via
+[executable](@ref executable) via
 the command line, or by setting it via a library call in an
 application.
 
diff --git a/docs/src/solvers.md b/docs/src/solvers.md
index 1aff0a1555..15a49f9225 100644
--- a/docs/src/solvers.md
+++ b/docs/src/solvers.md
@@ -5,7 +5,7 @@
 HiGHS has implementations of the three main solution techniques for
 LP. HiGHS will choose the most appropriate technique for a given
 problem, but this can be over-ridden by setting the option
-[__solver__](solver).
+[__solver__](@ref option-solver).
 
 ### Simplex
 
@@ -19,7 +19,7 @@ J. A. J. Hall, Mathematical Programming Computation, 10 (1), 119-142,
 2018 [DOI:
 10.1007/s12532-017-0130-5](https://link.springer.com/article/10.1007/s12532-017-0130-5).
 
-The option [__simplex\_strategy__](simplex\_strategy) determines whether the primal solver or one of hte parallel solvers is to be used. 
+The option [__simplex\_strategy__](@ref option-simplex_strategy) determines whether the primal solver or one of hte parallel solvers is to be used. 
 
 ### Interior point