org-toggle-heading

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


(org-toggle-heading &optional NSTARS)

Convert headings to normal text, or items or text to headings.
If there is no active region, only convert the current line.

With a C-u prefix, convert the whole list at
point into heading.

In a region:

- If the first non blank line is a headline, remove the stars
from all headlines in the region.

- If it is a normal line, turn each and every normal line (i.e.,
not an heading or an item) in the region into headings. If you
want to convert only the first line of this region, use one
universal prefix argument.

- If it is a plain list item, turn all plain list items into headings.

When converting a line into a heading, the number of stars is chosen
such that the lines become children of the current entry. However,
when a numeric prefix argument is given, its value determines the
number of stars to add.