diff --git a/README.org b/README.org
index 26f4818..a29fb4d 100644
--- a/README.org
+++ b/README.org
@@ -1828,6 +1828,18 @@ buffers with help of an external [[https://nodejs.org][node.js]] program.
 
 [[https://github.com/thisirs/dotemacs/blob/master/lisp/init-auctex.el][AUCTeX setup of an experienced user]]
 
+** Writing [[https://www.markdownguide.org/][Markdown]] files
+:PROPERTIES:
+:CUSTOM_ID: sec:writing-markdown-files
+:END:
+
+#+caption[Configure =markdown-mode=]:
+#+caption: Configure =markdown-mode=.
+#+name: lst:configure-markdown-mode
+#+begin_src emacs-lisp
+  (when (ensure-package-installation 'markdown-mode))
+#+end_src
+
 ** Writing Org files
 :PROPERTIES:
 :CUSTOM_ID: sec:writing-org-files