diff --git a/nixos/doc/manual/development/development.xml b/nixos/doc/manual/development/development.xml
index 5b2fedf1606..05c6a5b1134 100644
--- a/nixos/doc/manual/development/development.xml
+++ b/nixos/doc/manual/development/development.xml
@@ -15,5 +15,5 @@
-
+
diff --git a/nixos/doc/manual/development/testing-installer.chapter.md b/nixos/doc/manual/development/testing-installer.chapter.md
new file mode 100644
index 00000000000..2eaa0161492
--- /dev/null
+++ b/nixos/doc/manual/development/testing-installer.chapter.md
@@ -0,0 +1,18 @@
+# Testing the Installer {#ch-testing-installer}
+
+Building, burning, and booting from an installation CD is rather
+tedious, so here is a quick way to see if the installer works properly:
+
+```ShellSession
+# mount -t tmpfs none /mnt
+# nixos-generate-config --root /mnt
+$ nix-build '' -A config.system.build.nixos-install
+# ./result/bin/nixos-install
+```
+
+To start a login shell in the new NixOS installation in `/mnt`:
+
+```ShellSession
+$ nix-build '' -A config.system.build.nixos-enter
+# ./result/bin/nixos-enter
+```
diff --git a/nixos/doc/manual/development/testing-installer.xml b/nixos/doc/manual/development/testing-installer.xml
deleted file mode 100644
index 902f995fbc1..00000000000
--- a/nixos/doc/manual/development/testing-installer.xml
+++ /dev/null
@@ -1,22 +0,0 @@
-
- Testing the Installer
-
- Building, burning, and booting from an installation CD is rather tedious, so
- here is a quick way to see if the installer works properly:
-
-# mount -t tmpfs none /mnt
-# nixos-generate-config --root /mnt
-$ nix-build '<nixpkgs/nixos>' -A config.system.build.nixos-install
-# ./result/bin/nixos-install
- To start a login shell in the new NixOS installation in
- /mnt:
-
-$ nix-build '<nixpkgs/nixos>' -A config.system.build.nixos-enter
-# ./result/bin/nixos-enter
-
-
-
diff --git a/nixos/doc/manual/from_md/development/testing-installer.chapter.xml b/nixos/doc/manual/from_md/development/testing-installer.chapter.xml
new file mode 100644
index 00000000000..286d49f3c29
--- /dev/null
+++ b/nixos/doc/manual/from_md/development/testing-installer.chapter.xml
@@ -0,0 +1,22 @@
+
+ Testing the Installer
+
+ Building, burning, and booting from an installation CD is rather
+ tedious, so here is a quick way to see if the installer works
+ properly:
+
+
+# mount -t tmpfs none /mnt
+# nixos-generate-config --root /mnt
+$ nix-build '<nixpkgs/nixos>' -A config.system.build.nixos-install
+# ./result/bin/nixos-install
+
+
+ To start a login shell in the new NixOS installation in
+ /mnt:
+
+
+$ nix-build '<nixpkgs/nixos>' -A config.system.build.nixos-enter
+# ./result/bin/nixos-enter
+
+