improve some static pages

1 files changed, 17 insertions, 18 deletions

diff --git a/tech/xahkeys.mdwn b/tech/xahkeys.mdwn
index 1efd295..b6a0213 100644
--- a/tech/xahkeys.mdwn
+++ b/tech/xahkeys.mdwn
@@ -3,11 +3,12 @@
 I have figured out a set of window management key bindings which can be
 implemented under both X11 on GNU/Linux systems and Microsoft Windows.
 This lets you have
--   **run-or-raise keys** for your most commonly used programs (that is:
+
+*   **run-or-raise keys** for your most commonly used programs (that is:
     press one key to either launch the program or switch to its window);
--   **AeroSnap-style tiling**;
--   **focus-follow-mouse** and
--   **workspaces**
+*   **AeroSnap-style tiling**;
+*   **focus-follow-mouse** and
+*   **workspaces**
 
 ... all with **the same bindings** on your GNU/Linux machine and your
 Windows machine.
@@ -20,6 +21,8 @@ doesn't work very well with Emacs anyway. See the
 *Terminological note:* When I say 'window' I mean what most people think
 of as a window, that is, what Emacs users generally call a 'frame'.
 
+[[!toc]]
+
 The bindings
 ============
 
@@ -120,7 +123,16 @@ workflow. Emacs windows generally need to be fullscreen because lots of
 features of Emacs split the window into two. Due to this splitting, and
 unlike other text-based software such as programs made with ncurses,
 Emacs windows respond poorly to being shrunk and enlarged at regular
-intervals by the tiling window manager.[^1]
+intervals by the tiling window manager.[[!template id=note text="""
+There have been attempts to make Emacs always open new windows instead of splitting its windows. An older and more complicated setup
+is [One On One Emacs](http://emacswiki.org/emacs/OneOnOneEmacs)
+and a more recent package is
+[frames-only-mode](http://compsoc.man.ac.uk/~shep/tearing-out-the-emacs-window-manager.html).
+The author of the latter tells me, to my surprise, that he doesn't
+find himself constantly needing to tweak his Emacs configuration to
+stop cranky Emacs features he brings into use splitting windows
+instead of making new ones.
+"""]]
 
 A second problem for Emacs users is that Emacs is cross-platform, but
 tiling window managers aren't. If Emacs is the centre of your workflow
@@ -152,16 +164,3 @@ yourself workspaces. Many people have written about the benefits of
 run-or-raise shortcuts, which I first used under
 [StumpWM](https://stumpwm.github.io/).
 
-Notes
-=====
-
-[^1]: There have been attempts to make Emacs always open new windows
-    instead of splitting its windows. An older and more complicated
-    setup is [One On One
-    Emacs](http://emacswiki.org/emacs/OneOnOneEmacs) and a more recent
-    package is
-    [frames-only-mode](http://compsoc.man.ac.uk/~shep/tearing-out-the-emacs-window-manager.html).
-    The author of the latter tells me, to my surprise, that he doesn't
-    find himself constantly needing to tweak his Emacs configuration to
-    stop cranky Emacs features he brings into use splitting windows
-    instead of making new ones.