From a2e0f39df8bbe4da5b6aa0b3d0d597b5b2902c62 Mon Sep 17 00:00:00 2001 From: Albert Krewinkel Date: Sun, 28 Jun 2020 21:29:32 +0200 Subject: doc/org.md: document behavior of `smart` extension See discussion in #4788. Closes: #4387 --- doc/org.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) (limited to 'doc') diff --git a/doc/org.md b/doc/org.md index 8e147c5a9..b65782107 100644 --- a/doc/org.md +++ b/doc/org.md @@ -244,6 +244,33 @@ be parsed using default emphasis rules: #+pandoc-emphasis-pre: #+pandoc-emphasis-post: +`smart` extension +================= + +Org-mode allows to insert certain characters via special character +sequences. For example, instead of typing the Unicode /HORIZONTAL +ELLISPIS/ character `…` by hand, one can instead type tree dots +`...`. En dashes and em dashes can be written as `--` and `---` +respectively. Furthermore, quotation marks (`"`) and +apostrophe-quotes (`'`) can be treated in a "smart" way, +potentially replacing them with proper, language specific unicode +quotation characters. + +Like in Markdown, these behaviors can be turned on all-at-once by +enabling the `smart` extension. However, disabling `smart` (the +default) will *not* necessarily disable smart quotes and special +strings. Instead, it will just result in the default Org mode +behavior. + +The special string feature can be turned off via the `#+OPTIONS: +-:nil` [export setting]. There are currently no command line flags +which control these features. As a workaround, one can use process +substitution, a feature supported by most shells. It allows to +provide the options line on the command line: + + pandoc -f org <(printf "#+OPTIONS: -:nil\n") … + +[export setting]: https://orgmode.org/manual/Export-Settings.html Currently unsupported features ============================== -- cgit v1.2.3