Function: org-insert-subheading

org-insert-subheading is an interactive and byte-compiled function defined in org.el.gz.

Signature

(org-insert-subheading ARG)

Documentation

Insert a new subheading and demote it.

Works for outline headings and for plain lists alike. The prefix argument ARG is passed to org-insert-heading. Unlike org-insert-heading, when point is at the beginning of a heading, still insert the new sub-heading below.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/org/org.el.gz
(defun org-insert-subheading (arg)
  "Insert a new subheading and demote it.
Works for outline headings and for plain lists alike.
The prefix argument ARG is passed to `org-insert-heading'.
Unlike `org-insert-heading', when point is at the beginning of a
heading, still insert the new sub-heading below."
  (interactive "P")
  (when (and (bolp) (not (eobp)) (not (eolp))) (forward-char))
  (org-insert-heading arg)
  (cond
   ((org-at-heading-p) (org-do-demote))
   ((org-at-item-p) (org-indent-item))))