diff options
author | Albert Krewinkel <albert@zeitkraut.de> | 2020-06-28 21:29:32 +0200 |
---|---|---|
committer | Albert Krewinkel <albert@zeitkraut.de> | 2020-06-28 21:36:38 +0200 |
commit | a2e0f39df8bbe4da5b6aa0b3d0d597b5b2902c62 (patch) | |
tree | 2fb343e5333da2fc14be1056127341c323373808 /doc/org.md | |
parent | 8a1690dec1482d5fe5838a3441cd73b81c7c8bf4 (diff) | |
download | pandoc-a2e0f39df8bbe4da5b6aa0b3d0d597b5b2902c62.tar.gz |
doc/org.md: document behavior of `smart` extension
See discussion in #4788.
Closes: #4387
Diffstat (limited to 'doc/org.md')
-rw-r--r-- | doc/org.md | 27 |
1 files changed, 27 insertions, 0 deletions
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 ============================== |