Как иметь pandoc оставить процентные знаки в одиночку?

Question

Я пишу несколько команд LaTeX внутри источника Markdown, который я хотел бы прокомментировать, используя знак процента %. К сожалению, pandoc ускользает от этого до \%, который, таким образом, набирается вместо запуска комментария. Вручную убежать от него как \% ничего не меняет (и почему это должно быть?), Поэтому мой вопрос: как не избежать % в источнике уценки?

Answer 1

Задать вопрос, как написать комментарий в Markdown, начиная с %, это как задать, как написать комментарий HTML, начиная с %. Ты просто не можешь.

Однако, есть несколько возможностей для комментариев:

1. Синтаксис комментариев в Markdown Pandoc является заимствованы из HTML, поэтому следующие работы:

   <!-- my comment--> 
   

2. Использование команд рядный TeX :

   \begin{comment} 
   my comment 
   \end{comment} 
   

3. Вы также можете (ab-) использовать YAML Metadata blocks как комментарии: (. Оставляя что-то folowed двоеточия будет работать так же, давая вам предупреждение, однако)

   my text 
   
   --- 
   c: my comment 
   --- 
   
   more text 
   

4. Вы можете написать pandoc filter удалить конструкции, которые вы хотите использовать в качестве комментарии, например код охватывает с классом c:

   `my comment`{.c} 
   

5. Используйте препроцессор как gpp in front of pandoc.

6. И да, вы всегда можете вернуться к perl-скриптам и регулярным выражениям. Но у них есть опасность сопоставить ложные срабатывания и взломать ваш документ ...