org-insert-heading

org-insert-heading is an interactive compiled Lisp function in `org.el'.


(org-insert-heading &optional ARG INVISIBLE-OK)

Insert a new heading or an item with the same depth at point.

If point is at the beginning of a heading or a list item, insert
a new heading or a new item above the current one. If point is
at the beginning of a normal line, turn the line into a heading.

If point is in the middle of a headline or a list item, split the
headline or the item and create a new headline/item with the text
in the current line after point (see `org-M-RET-may-split-line'
on how to modify this behavior).

With one universal prefix argument, set the user option
`org-insert-heading-respect-content' to t for the duration of
the command. This modifies the behavior described above in this
ways: on list items and at the beginning of normal lines, force
the insertion of a heading after the current subtree.

With two universal prefix arguments, insert the heading at the
end of the grandparent subtree. For example, if point is within
a 2nd-level heading, then it will insert a 2nd-level heading at
the end of the 1st-level parent heading.

When INVISIBLE-OK is set, stop at invisible headlines when going
back. This is important for non-interactive uses of the
command.