orgmode 中的注释行

Comment lines in orgmode

使用注释行查阅组织文档:

The Org Manual: Comment lines

12.6 Comment lines

Lines starting with zero or more whitespace characters followed by one ‘#’ and a whitespace are treated as comments and, as such, are not exported.

Likewise, regions surrounded by #+BEGIN_COMMENT ... #+END_COMMENT are not exported.

Finally, a ‘COMMENT’ keyword at the beginning of an entry, but after any other keyword or priority cookie, comments out the entire subtree. In this case, the subtree is not exported and no code block within it is executed either129. The command below helps changing the comment status of a headline.

C-c ;

Toggle the ‘COMMENT’ keyword at the beginning of an entry.

#+BEGIN_COMMENT … #+END_COMMENT 工作正常。

然而,

Lines starting with zero or more whitespace characters followed by one ‘#’ and a whitespace are treated as comments and, as such, are not exported.

我是不是误解了这个说法?

你读得很好:工作注释语法是

#+BEGIN_COMMENT
this is a comment
#+END_COMMENT

# this is a comment (needs at least one first whitespace after #)

但是

#this is not a comment (it is exported as "#this is not a comment")