When working on the structure of a document, often I find myself wanting to turn a list of items into a set of headings, or a set of headings into a list. I haven't found a way to do this easily other than by hand-editing or recording a macro.

How do you do it? Is there a function to do this kind of operations, e.g. demote a heading to a list item?


In org-mode, it is very easy to turn heading into item. A command called org-toggle-item can do that, and it is binded a default key with C-c -.

Additionally, you can also use org-toggle-heading to turn an item to heading, which is binded with C-c *.

  • 1
    This happened to me by chance several times, but I never could figure out what key did I press to achieve this effect! :) – wvxvw Feb 1 '15 at 20:21
  • 2
    Just as a sidenote: "C-c *" is bound to org-ctrl-c-star at least today. But this function decides by context what to do. It either calls org-table-recalculate or org-toggle-heading. – Matthias Dec 27 '16 at 9:18
  • 2
    The tricky thing is that both headings and list items can start with *. So supposedly, if there are no leading spaces before *, it is a heading. But then people seem to make it not display all the asterisks for headings, and the distinction probably gets even more blurry. – x-yuri Jul 12 '20 at 10:07

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.