pandoc - מקוון בענן

תָכְנִית:

שֵׁם

pandoc - ממיר סימון כללי

תַקצִיר

פנדוק [אפשרויות] [קובץ קלט] ...

תיאור

Pandoc היא ספריית Haskell להמרה מפורמט סימון אחד למשנהו, וכן א
כלי שורת פקודה שמשתמש בספרייה זו. זה יכול לקרוא Markdown, CommonMark, PHP Markdown
תוספת, Markdown בטעם GitHub, ו(קבוצות משנה של) טקסטיל, reStructuredText, HTML, LaTeX,
סימון MediaWiki, סימון TWiki, סימון Haddock, OPML, מצב Emacs Org, DocBook, txt2tags,
EPUB, ODT ו- Word docx; והוא יכול לכתוב טקסט רגיל, Markdown, CommonMark, PHP Markdown
Extra, Markdown בטעם GitHub, reStructuredText, XHTML, HTML5, LaTeX (כולל beamer
הצגת שקופיות), ConTeXt, RTF, OPML, DocBook, OpenDocument, ODT, Word docx, GNU Texinfo,
סימון MediaWiki, סימון DokuWiki, סימון Haddock, EPUB (v2 או v3), FictionBook2, Textile,
groff man pages, Emacs Org mode, AsciiDoc, InDesign ICML ו-Slidy, Slideous, DZSlides,
הצגת שקופיות של reveal.js או S5 HTML. זה יכול גם לייצר פלט PDF במערכות שבהן LaTeX,
ConTeXt, או wkhtmltopdf מותקן.

הגרסה המשופרת של Pandoc של Markdown כוללת תחביר להערות שוליים, טבלאות, גמיש
רשימות מסודרות, רשימות הגדרות, בלוקי קוד מגודרים, כתוביות עילית וכתובות משנה,
מחיקה, בלוקים של מטא נתונים, תוכן עניינים אוטומטי, מתמטיקה משובצת של LaTeX, אזכורים,
ו-Markdown בתוך רכיבי בלוק HTML. (שיפורים אלה, המתוארים להלן מתחת
Pandoc's Markdown, ניתן להשבית באמצעות פורמט הקלט או הפלט markdown_strict.)

בניגוד לרוב הכלים הקיימים להמרת Markdown ל-HTML, המשתמשים ב-regex
תחליפי, ל-pandoc יש עיצוב מודולרי: הוא מורכב מקבוצה של קוראים, שמנתחים
טקסט בפורמט נתון ולייצר ייצוג מקורי של המסמך, וקבוצה של
כותבים, אשר ממירים את הייצוג המקומי הזה לפורמט יעד. לפיכך, הוספת an
פורמט קלט או פלט דורש רק הוספת קורא או כותב.

כי ייצוג הביניים של Pandoc של מסמך הוא פחות אקספרסיבי מרבים מהם
הפורמטים שהוא ממיר ביניהם, אין לצפות להמרות מושלמות בין כל אחד
פורמט וכל אחד אחר. פנדוק מנסה לשמר את האלמנטים המבניים של א
מסמך, אך לא עיצוב פרטים כגון גודל השוליים. וכמה רכיבי מסמך,
כגון טבלאות מורכבות, עשוי שלא להתאים למודל המסמכים הפשוט של Pandoc. בזמן
המרות מ-Pandoc's Markdown לכל הפורמטים שואפות להיות מושלמות, המרות מ
ניתן לצפות כי פורמטים אקספרסיביים יותר מ-Markdown של Pandoc יהיו אובדניים.

שימוש פנדוק
אם לא קובץ קלט מצוין, הקלט נקרא סטדין. אחרת ה קבצי קלט יש לו
משורשרים (עם שורה ריקה בין כל אחד) ומשמשת כקלט. הפלט הולך אל stdout by
ברירת מחדל (אם כי פלט ל stdout מושבת עבור הפלט odt, docx, epub ו-epub3
פורמטים). עבור פלט לקובץ, השתמש באפשרות -o:

pandoc -o output.html input.txt

כברירת מחדל, Pandoc מייצר קטע מסמך, לא מסמך עצמאי עם פרופר
כותרת עליונה ותחתונה. כדי להפיק מסמך עצמאי, השתמש בדגל -s או --standalone:

pandoc -s -o output.html input.txt

למידע נוסף על אופן הפקת מסמכים עצמאיים, ראה תבניות, להלן.

במקום קובץ, ניתן לתת URI מוחלט. במקרה זה pandoc יביא את
תוכן באמצעות HTTP:

pandoc -f html -t markdown http://www.fsf.org

אם ניתנים קבצי קלט מרובים, Pandoc ישרשר את כולם (עם שורות ריקות
ביניהם) לפני הניתוח. תכונה זו מושבתת עבור פורמטי קלט בינאריים כגון
EPUB, odt ו-docx.

ניתן לציין את הפורמט של הקלט והפלט במפורש באמצעות אפשרויות שורת הפקודה.
ניתן לציין את פורמט הקלט באמצעות האפשרויות -r/--read או -f/--from, הפלט
פורמט באמצעות האפשרויות -w/--write או -t/--to. לפיכך, להמיר hello.txt מ-Markdown
ל-LaTeX, אתה יכול להקליד:

pandoc -f markdown -t latex hello.txt

כדי להמיר hello.html מ-HTML ל-Markdown:

pandoc -f html -t markdown hello.html

פורמטי פלט נתמכים מפורטים להלן תחת האפשרות -t/--to. קלט נתמך
הפורמטים מפורטים למטה תחת האפשרות -f/--from. שימו לב שהראשון, טקסטיל, לטקס,
וקוראי HTML אינם שלמים; יש כמה מבנים שהם לא מנתחים.

אם פורמט הקלט או הפלט לא מצוין במפורש, Pandoc ינסה לנחש זאת
מההרחבות של שמות הקלט והפלט. כך, למשל,

pandoc -o hello.tex hello.txt

ימיר hello.txt מ-Markdown ל-LaTeX. אם לא צוין קובץ פלט (כך ש
הפלט הולך אל stdout), או אם הסיומת של קובץ הפלט אינה ידועה, פורמט הפלט
יהיה ברירת המחדל ל-HTML. אם לא צוין קובץ קלט (כך שהקלט מגיע מ סטדין), או
אם הסיומות של קבצי הקלט אינן ידועות, יש להניח שפורמט הקלט הוא
סימון למטה אלא אם צוין במפורש.

Pandoc משתמש בקידוד התווים UTF-8 עבור קלט ופלט כאחד. אם אתה מקומי
קידוד תווים אינו UTF-8, אתה צריך להעביר קלט ופלט דרך iconv:

iconv -t utf-8 input.txt | פנדוק | iconv -f utf-8

שים לב שבפורמטים מסוימים של פלט (כגון HTML, LaTeX, ConTeXt, RTF, OPML, DocBook ו
Texinfo), מידע על קידוד התווים כלול בכותרת המסמך,
אשר ייכלל רק אם אתה משתמש באפשרות העצמאית -s/--.

יוצרים a PDF
להפקת PDF, ציין קובץ פלט עם סיומת .pdf. כברירת מחדל, Pandoc יעשה זאת
השתמש ב-LaTeX כדי להמיר אותו ל-PDF:

pandoc test.txt -o test.pdf

הפקת PDF מחייבת התקנת מנוע LaTeX (ראה --latex-engine, להלן),
ומניח שהחבילות הבאות של LaTeX זמינות: amsfonts, amsmath, lm,
ifxetex, ifluatex, eurosym, רשימות (אם נעשה שימוש באפשרות --listings), fancyvrb,
longtable, booktabs, graphicx ו-grffile (אם המסמך מכיל תמונות), hyperref,
ulem, גיאומטריה (עם קבוצת משתני הגיאומטריה), setspace (עם linestretch) ו-babel
(עם לאנג). השימוש ב-xelatex או lualatex כמנוע ה-LaTeX דורש מפרט גופנים;
xelatex משתמש ב-mathspec, polyglossia (עם lang), xecjk ובידי (עם המשתנה dir
מַעֲרֶכֶת). נעשה שימוש בחבילות upquote ו-microtype אם זמינות, ויעשה שימוש ב-csquotes
עבור סימני פיסוק חכמים אם מוסיפים לתבנית או נכללים בקובץ כותרות כלשהו. ה
ניתן להשתמש בחבילות natbib, biblatex, bibtex וביבר באופן אופציונלי לציטוט
טִיוּחַ. אלה כלולים בכל הגרסאות האחרונות של TeX Live.

לחלופין, Pandoc יכול להשתמש ב-ConTeXt או wkhtmltopdf כדי ליצור PDF. כדי לעשות זאת, ציין
קובץ פלט עם סיומת .pdf, כמו קודם, אך הוסף -t context או -t html5 ל-
שורת הפקודה.

ניתן לשלוט בפלט PDF באמצעות משתנים עבור LaTeX (אם נעשה שימוש ב-LaTeX) ומשתנים
עבור ConTeXt (אם נעשה שימוש ב-ConTeXt). אם נעשה שימוש ב-wkhtmltopdf, אז המשתנים margin-left,
שוליים-ימין, שוליים-עליון, שוליים-תחתונים וגודל נייר ישפיעו על הפלט, כמו כן
--css.

אפשרויות

כללי אפשרויות
-f פורמט, -r פורמט, --מ=פורמט, --קרא=פורמט
ציין פורמט קלט. פורמט יכול להיות מקורי (מקורי Haskell), json (גרסת JSON של
AST מקורי), markdown (Markdown המורחב של Pandoc), markdown_strict (מקורי
Markdown unextended), markdown_phpextra (PHP Markdown Extra), markdown_github
(Markdown בטעם GitHub), סימן משותף (CommonMark Markdown), טקסטיל (טקסטיל),
rst (reStructuredText), html (HTML), docbook (DocBook), t2t (txt2tags), docx
(docx), odt (ODT), epub (EPUB), opml (OPML), org (מצב Emacs Org), mediawiki
(סימון MediaWiki), twiki (סימון TWiki), חדוק (סימון חדוק) או לטקס
(שרף גומי). אם +lhs מצורף ל-markdown, rst, latex או html, הקלט יהיה
מטופל כמקור Haskell יודע קרוא וכתוב: ראה תמיכת Haskell אוריינית, להלן. Markdown
ניתן להפעיל או להשבית תוספי תחביר בנפרד על ידי הוספת +EXTENSION
או -EXTENSION לשם הפורמט. אז, למשל,
markdown_strict+footnotes+definition_lists הוא Markdown קפדני עם הערות שוליים ו
רשימות הגדרות מופעלות, ו-markdown-pipe_tables+hard_line_breaks הוא Pandoc's
Markdown ללא טבלאות צינור ועם הפסקות קו קשיח. ראה את ה-Pandoc's Markdown,
להלן, לרשימה של הרחבות ושמותיהם.

-t פורמט, -w פורמט, --to=פורמט, --כתוב=פורמט
ציין פורמט פלט. פורמט יכול להיות מקורי (מקורי Haskell), json (גרסת JSON
של AST מקורי), רגיל (טקסט רגיל), Markdown (Markdown המורחב של Pandoc),
markdown_strict (Markdown לא מורחב מקורי), markdown_phpextra (PHP Markdown
Extra), markdown_github (Markdown בטעם GitHub), סימן משותף (CommonMark
Markdown), rst (reStructuredText), html (XHTML), html5 (HTML5), לטקס (LaTeX),
beamer (הצגת שקופיות של LaTeX beamer), הקשר (ConTeXt), גבר (גבר גרוף), mediawiki
(סימון MediaWiki), dokuwiki (סימון DokuWiki), טקסטיל (טקסטיל), org (Emacs Org
mode), texinfo (GNU Texinfo), opml (OPML), docbook (DocBook), opendocument
(OpenDocument), odt (מסמך טקסט של OpenOffice), docx (Word docx), Haddock (Haddock
סימון), rtf (פורמט טקסט עשיר), epub (ספר EPUB v2), epub3 (EPUB v3), fb2
(ספר אלקטרוני FictionBook2), asciidoc (AsciiDoc), icml (InDesign ICML), slidy (Slidy HTML
והצגת שקופיות javascript), slideous (Slideous HTML ו-javascript שקופיות),
dzslides (DZSlides HTML5 + הצגת שקופיות javascript), revealjs (reveal.js HTML5 +
הצגת שקופיות javascript), s5 (S5 HTML ו-javascript הצגת שקופיות), או הנתיב של a
סופר lua מותאם אישית (ראה כותבים מותאם אישית, להלן). שימו לב ש-odt, epub ו-epub3
הפלט לא יופנה אליו stdout; יש לציין שם קובץ פלט באמצעות
אפשרות הפלט -o/--. אם +lhs מצורף ל-markdown, rst, latex, beamer, html,
או html5, הפלט יעובד כמקור Haskell יודע קרוא וכתוב: ראה Literate
תמיכת Haskell, למטה. ניתן להפעיל תוספות תחביר של Markdown בנפרד או
מושבת על ידי הוספת +EXTENSION או -EXTENSION לשם הפורמט, כמתואר
לעיל מתחת -ו.

-o קובץ, --פלט=קובץ
כתוב פלט ל קובץ במקום stdout. אם קובץ הוא -, הפלט יעבור אל stdout.
(חריג: אם פורמט הפלט הוא odt, docx, epub או epub3, הפלט ל-stdout הוא
נָכֶה.)

--data-dir=DIRECTORY
ציין את ספריית נתוני המשתמש כדי לחפש קובצי נתוני Pandoc. אם אפשרות זו היא
לא צוין, תיעשה שימוש בספריית נתוני המשתמש המוגדרת כברירת מחדל. זה, ביוניקס:

$HOME/.pandoc

ב-Windows XP:

C:\Documents And Settings\USERNAME\Application Data\pandoc

וב-Windows Vista ואילך:

C:\Users\USERNAME\AppData\Roaming\pandoc

אתה יכול למצוא את ספריית ברירת המחדל של נתוני המשתמש במערכת שלך על ידי התבוננות ב-
פלט של pandoc --גרסה. A reference.odt, reference.docx, epub.css, templates,
ספריית slidy, slideous או s5 הממוקמת בספרייה זו תעקוף את Pandoc's
ברירות מחדל רגילות.

--השלמת bash
צור סקריפט להשלמת bash. כדי לאפשר השלמת bash עם pandoc, הוסף את זה
ל-bashrc שלך:

eval "$(pandoc --bash-completion)"

--מִלוּלִי
תן פלט איתור באגים מילולי. כרגע זה משפיע רק על פלט PDF.

-ב, --גִרְסָה
גרסת הדפסה.

-ח, - עזרה
הצג הודעת שימוש.

קורא אפשרויות
-ר, --נתח-גולמי
נתח קודי HTML בלתי ניתנים לתרגום וסביבות LaTeX כ-HTML גולמי או LaTeX,
במקום להתעלם מהם. משפיע רק על קלט HTML ו-LaTeX. HTML גולמי יכול להיות
מודפס ב-Markdown, reStructuredText, HTML, Slidy, Slideous, DZSlides, reveal.js,
ופלט S5; ניתן להדפיס LaTeX גולמי ב-Markdown, reStructuredText, LaTeX ו
פלט ConTeXt. ברירת המחדל היא שהקוראים ישמיטו קודי HTML בלתי ניתנים לתרגום
וסביבות LaTeX. (קורא LaTeX אכן עובר דרך LaTeX בלתי ניתן לתרגום
פקודות, גם אם לא צוין -R.)

-S, --לִכאוֹב
הפקת פלט נכון מבחינה טיפוגרפית, המרת מרכאות ישרות למרכאות מתולתלות,
--- ל-em-מקפים, -- ל-en-מקפים, ו... לאליפסות. רווחים לא שוברים הם
מוכנס אחרי קיצורים מסוימים, כגון "מר". (הערה: אפשרות זו נבחרת
אוטומטית כאשר פורמט הפלט הוא לטקס או הקשר, אלא אם כן --no-tex-ligatures
משמש. אין לזה השפעה על קלט לטקס.)

--מקפים ישנים
בוחר את ההתנהגות Pandoc <= 1.8.2.1 לניתוח מקפים חכמים: - לפני ספרה
הוא מקף מקף, ו-- הוא מקף em. אפשרות זו נבחרת אוטומטית עבור
קלט טקסטיל.

--base-header-level=מספר
ציין את רמת הבסיס לכותרות (ברירת המחדל היא 1).

--indented-code-classes=שיעורים
ציין מחלקות לשימוש עבור בלוקי קוד מוזחים--לדוגמה, perl,numberLines או
haskel. ניתן להפריד בין מחלקות מרובות באמצעות רווחים או פסיקים.

--default-image-extension=הארכת
ציין סיומת ברירת מחדל לשימוש כאשר לנתיבי תמונה/כתובות אתרים אין סיומת. זֶה
מאפשר לך להשתמש באותו מקור עבור פורמטים הדורשים סוגים שונים של
תמונות. נכון לעכשיו אפשרות זו משפיעה רק על קוראי Markdown ו-LaTeX.

--פילטר=ניתן לביצוע
ציין קובץ הפעלה שישמש כמסנן ההופך את ה-pandoc AST לאחר ה-
הקלט מנותח ולפני שהפלט נכתב. קובץ ההפעלה צריך לקרוא JSON
מ-stdin וכתוב JSON ל-stdout. ה-JSON חייב להיות מעוצב כמו זה של Pandoc
קלט ופלט של JSON. שם פורמט הפלט יועבר למסנן
כטיעון הראשון. לָכֵן,

pandoc --filter ./caps.py -t לטקס

שווה

pandoc -t json | ./caps.py לטקס | pandoc -f json -t latex

הטופס האחרון עשוי להיות שימושי לאיתור באגים במסננים.

ניתן לכתוב מסננים בכל שפה. Text.Pandoc.JSON מייצא לJSONFilter אל
להקל על כתיבת מסננים ב- Haskell. אלה שיעדיפו לכתוב פילטרים
python יכול להשתמש במודול pandocfilters, שניתן להתקנה מ- PyPI. יש גם
ספריות סינון pandoc ב-PHP, perl ו-javascript/node.js.

שים לב כי ניתן לביצוע יחפשו ב-PATH של המשתמש, ולא בעבודה
ספרייה, אם לא מסופקת ספריה. אם אתה רוצה להריץ סקריפט בעבודה
ספרייה, הקדמת שם הקובץ עם ./.

-M מפתח[=מדד], --metadata=מפתח[:מדד]
הגדר את שדה המטא נתונים מפתח לערך מדד. ערך שצוין בשורת הפקודה
עוקף ערך שצוין במסמך. הערכים ינותחו כ-YAML בוליאני
או ערכי מחרוזת. אם לא צוין ערך, הערך יטופל כבולאני
נָכוֹן. כמו --variable, --metadata גורם להגדרת משתני תבנית. אבל בניגוד
--variable, --metadata משפיע על המטא נתונים של המסמך הבסיסי (שהוא
נגיש ממסננים ועשוי להיות מודפס בפורמטים מסוימים של פלט).

--לנרמל
נרמל את המסמך לאחר הקריאה: מיזוג רכיבי Str או Emph סמוכים, עבור
לדוגמה, והסר רווחים חוזרים.

-פ, --לשמור-כרטיסיות
שמור על כרטיסיות במקום להמיר אותן לרווחים (ברירת המחדל). שימו לב שזה
ישפיע רק על כרטיסיות בטווחי קוד מילוליים ובלוקי קוד; כרטיסיות בטקסט רגיל
יטופלו כחללים.

--tab-stop=מספר
ציין את מספר הרווחים לכל טאב (ברירת המחדל היא 4).

--track-changes=accept|reject|all
מציין מה לעשות עם הוספות ומחיקות שנוצרו על ידי MS Word "Track
שינויים". קבל (ברירת המחדל), מוסיף את כל ההוספות ומתעלם מכולם
מחיקות. דחה מוסיף את כל המחיקות ומתעלם מהוספות. הכל מכניס את שניהם
הוספות ומחיקות, עטופים בטווחים עם מחלקות הכנסה ומחיקה,
בהתאמה. המחבר וזמן השינוי כלולים. הכל שימושי עבור
סקריפטים: קבלת שינויים רק מסוקר מסוים, למשל, או לפני מסוים
תַאֲרִיך. אפשרות זו משפיעה רק על קורא ה-docx.

--extract-media=DIR
חלץ תמונות ומדיה אחרת הכלולים במיכל docx או epub אל הנתיב
DIR, צור אותו במידת הצורך, והתאם את ההפניות לתמונות במסמך כך
הם מצביעים על הקבצים שחולצו. אפשרות זו משפיעה רק על docx ו-epub
הקוראים.

כללי סופר אפשרויות
-ס, - עצמאי
הפק פלט עם כותרת עליונה ותחתונה מתאימות (למשל HTML עצמאי,
קובץ LaTeX, או RTF, לא קטע). אפשרות זו מוגדרת אוטומטית עבור pdf,
פלט epub, epub3, fb2, docx ו-odt.

--תבנית=קובץ
השתמש קובץ כתבנית מותאמת אישית עבור המסמך שנוצר. מרמז על - עצמאי.
ראה תבניות, להלן, לתיאור של תחביר תבניות. אם אין הרחבה
שצוין, תתווסף הרחבה המתאימה לכותב, כך
--template=special מחפש special.html עבור פלט HTML. אם התבנית לא
נמצא, Pandoc יחפש אותו בספריית המשנה של התבניות של נתוני המשתמש
ספרייה (ראה --data-dir). אם אפשרות זו אינה בשימוש, תבנית ברירת מחדל
ייעשה שימוש המתאים לפורמט הפלט (ראה -D/--print-default-template).

-V מפתח[=מדד], --משתנה=מפתח[:מדד]
הגדר את משתנה התבנית מפתח לערך מדד בעת עיבוד המסמך
מצב עצמאי. בדרך כלל זה שימושי רק כאשר נעשה שימוש באפשרות --template
כדי לציין תבנית מותאמת אישית, מכיוון ש-pandoc מגדיר אוטומטית את המשתנים שבהם נעשה שימוש
תבניות ברירת המחדל. אם לא מדד מצוין, המפתח יקבל את הערך
נכון.

-D פורמט, --print-default-template=פורמט
הדפס את תבנית ברירת המחדל של המערכת עבור פלט פורמט. (ראה -t לרשימה של
אפשרי פורמטס.) מתעלמים מתבניות בספריית נתוני המשתמש.

--print-default-data-file=קובץ
הדפס קובץ נתוני ברירת מחדל של המערכת. מתעלמים מקבצים בספריית נתוני המשתמש.

--dpi=מספר
ציין את ערך dpi (נקודות לאינץ') להמרה מפיקסלים ל
אינץ'/סנטימטרים ולהיפך. ברירת המחדל היא 96dpi. טכנית, נכון
המונח יהיה ppi (פיקסלים לאינץ').

--wrap=[auto|none|preserve]
קבע כיצד טקסט עטוף בפלט (קוד המקור, לא המעובד
גִרְסָה). עם אוטומטי (ברירת המחדל), pandoc ינסה לעטוף שורות לעמוד
רוחב שצוין על ידי --עמודות (ברירת מחדל 80). עם אף אחד, Pandoc לא יעטוף שורות
בכלל. עם שימור, Pandoc ינסה לשמר את העטיפה מה-
מסמך מקור (כלומר, כאשר יש שורות חדשות לא סמנטיות במקור, שם
יהיו שורות חדשות לא סמנטיות גם בפלט).

--ללא עטיפה
מילה נרדפת הוצאה משימוש עבור --wrap=none.

--עמודות=מספר
ציין אורך שורות בתווים (עבור גלישת טקסט). זה משפיע רק על
קוד המקור שנוצר, לא הפריסה בדף המעובד.

--טוק, --תוכן העניינים
כלול תוכן עניינים שנוצר אוטומטית (או, במקרה של לטקס,
הקשר, וראשית, הוראה ליצור אחד) במסמך הפלט. זֶה
לאפשרות אין השפעה על פלט man, docbook, slide, slideous, s5, docx או odt.

--toc-depth=מספר
ציין את מספר רמות הסעיפים שיש לכלול בתוכן העניינים. ה
ברירת המחדל היא 3 (מה שאומר שכותרות רמה 1, 2 ו-3 יופיעו ב-
תוכן).

--אין-הדגשה
משבית את הדגשת התחביר עבור בלוקי קוד ושורות מוטבעות, גם כאשר מדובר בשפה
ניתנת תכונה.

--highlight-style=סגנון
מציין את סגנון הצביעה שישמש בקוד המקור המודגש. אפשרויות הן
פיגמנטים (ברירת המחדל), קייט, מונוכרום, אספרסו, זנבורן, חדו וטנגו.
למידע נוסף על הדגשת תחביר ב-pandoc, ראה הדגשת תחביר,
לְהַלָן.

-H קובץ, --include-in-header=קובץ
כלול תוכן של קובץ, מילה במילה, בסוף הכותרת. אפשר להשתמש בזה,
לדוגמה, לכלול CSS מיוחד או javascript במסמכי HTML. אפשרות זו
ניתן להשתמש שוב ושוב כדי לכלול מספר קבצים בכותרת. הם יהיו
כלול בסדר שצוין. מרמז על - עצמאי.

-B קובץ, --include-before-body=קובץ
כלול תוכן של קובץ, מילה במילה, בתחילת גוף המסמך (למשל
לאחר תג ב-HTML, או הפקודה \begin{document} ב-LaTeX). זה יכול
לשמש לכלול סרגלי ניווט או באנרים במסמכי HTML. אפשרות זו יכולה
לשמש שוב ושוב כדי לכלול מספר קבצים. הם ייכללו בהזמנה
נָקוּב. מרמז על - עצמאי.

-A קובץ, --include-after-body=קובץ
כלול תוכן של קובץ, מילה במילה, בסוף גוף המסמך (לפני ה
תג ב-HTML, או הפקודה \end{document} ב-LaTeX). אפשרות זו יכולה להיות
לשמש שוב ושוב כדי לכלול מספר קבצים. הם ייכללו בהזמנה
נָקוּב. מרמז על - עצמאי.

אפשרויות משפיע ספציפי סופרים
--מסוגל
הפק קובץ HTML עצמאי ללא תלות חיצונית, תוך שימוש בנתונים: URIs to
לשלב את התוכן של סקריפטים מקושרים, גיליונות סגנונות, תמונות וסרטונים. ה
הקובץ המתקבל צריך להיות "מכיל את עצמו", במובן זה שהוא לא צריך חיצוני
קבצים וללא גישה נטו שיוצגו כראוי על ידי דפדפן. אפשרות זו עובדת
רק עם פורמטים של פלט HTML, כולל html, html5, html+lhs, html5+lhs, s5,
slidy, slideous, dzslides וגילויים. סקריפטים, תמונות וגיליונות סגנונות ב
כתובות URL מוחלטות יורדו; אלה בכתובות URL יחסיות יחפשו ביחס אליהן
ספריית העבודה (אם קובץ המקור הראשון הוא מקומי) או יחסית לבסיס
כתובת URL (אם קובץ המקור הראשון מרוחק). הגבלה: משאבים שנטענים
לא ניתן לשלב באופן דינמי דרך JavaScript; כתוצאה,
--עצמי אינו עובד עם --mathjax, וכמה תכונות מתקדמות (למשל
זום או הערות דובר) עשויים שלא לעבוד בשקופית "עצמה" של reveal.js במצב לא מקוון
לְהַצִיג.

--html-q-tags
השתמש בתגיות עבור מרכאות ב-HTML.

--ascii
השתמש רק בתווי ascii בפלט. כרגע נתמך רק עבור פלט HTML
(אשר משתמש בישויות מספריות במקום UTF-8 כאשר אפשרות זו נבחרת).

-- קישורי עזר
השתמש בקישורים בסגנון הפניה, במקום בקישורים מוטבעים, בכתיבת Markdown או
reStructuredText. כברירת מחדל, נעשה שימוש בקישורים מוטבעים.

--atx-headers
השתמש בכותרות בסגנון ATX בפלט Markdown ו-asciidoc. ברירת המחדל היא להשתמש
כותרות בסגנון setext לרמות 1-2, ולאחר מכן כותרות ATX.

--פרקים
התייחס לכותרות ברמה העליונה כאל פרקים בפלט LaTeX, ConTeXt ו-DocBook. מתי
מחלקת המסמכים של LaTeX מוגדרת לדוח, ספר או זיכרונות, אפשרות זו משתמעת.
אם beamer הוא פורמט הפלט, הכותרות ברמה העליונה יהפכו ל-\part{..}.

-נ, --מספר-סעיפים
כותרות מקטע מספרים בפלט LaTeX, ConTeXt, HTML או EPUB. כברירת מחדל,
חלקים אינם ממוספרים. קטעים עם מחלקה לא ממוספרת לעולם לא יספרו,
גם אם --number-sections מצוין.

--number-offset=מספר[,מספר,...]
היסט עבור כותרות מקטעים בפלט HTML (מתעלמים ממנו בתבניות פלט אחרות). ה
המספר הראשון מתווסף למספר המקטע עבור כותרות ברמה העליונה, השני עבור
כותרות ברמה השנייה וכן הלאה. אז, למשל, אם אתה רוצה את הרמה העליונה הראשונה
הכותרת במסמך שלך תהיה ממוספרת "6", ציין --number-offset=5. אם שלך
מסמך מתחיל עם כותרת רמה 2 שאותה ברצונך למספר "1.5", ציין
--number-offset=1,4. ההסטות הן 0 כברירת מחדל. מרמז על --מספר-סעיפים.

--ללא ליגטורות טקסט
אל תשתמש בקשרי TeX עבור מרכאות, אפוסתרופים ומקפים (`...',
``..'', --, ---) בעת כתיבה או קריאה של LaTeX או ConTeXt. בקריאת LaTeX, נתח
התווים `, ', ו - פשוטו כמשמעו, במקום ניתוח ליגטורות לצורך ציטוט
סימנים ומקפים. בכתיבת LaTeX או ConTeXt, הדפס מרכאות Unicode ו
תווי מקף פשוטו כמשמעו, במקום להמיר אותם ל-ASCII TeX הסטנדרטי
קשירות. הערה: בדרך כלל --smart נבחר אוטומטית עבור LaTeX ו-ConTeXt
פלט, אך יש לציין אותו במפורש אם נבחרה --no-tex-ligatures. אם
אתה משתמש במירכאות מתולתלות מילוליות, מקפים ואליפסות במקור שלך, אז אתה יכול
רוצה להשתמש ב--no-tex-ligatures ללא --smart.

--רישומים
השתמש בחבילת הרישומים עבור בלוקי קוד LaTeX

-אני, --מצטבר
הפוך פריטי רשימה בהצגת שקופיות להצגה הדרגתית (אחד אחד). ברירת המחדל היא
כדי שהרשימות יוצגו בבת אחת.

--שקופית ברמה=מספר
מציין שכותרות עם הרמה שצוינה יוצרות שקופיות (עבור beamer, s5,
slidy, slideous, dzslides). כותרות מעל רמה זו בהיררכיה רגילים
חלקו את הצגת השקופיות לחלקים; כותרות מתחת לרמה זו יוצרות כותרות משנה
בתוך שקופית. ברירת המחדל היא להגדיר את רמת השקופית על סמך התוכן של
מסמך; ראה מבנה הצגת השקופיות.

--מקטעים
עטוף קטעים פנימה תגים (או תגים ב-HTML5), ולצרף לזה מזהים
התוחם (אוֹ ) במקום הכותרת עצמה. ראה כותרת
מזהים, להלן.

--email-obfuscation=none|javascript|הפניות
ציין שיטה לערפול mailto: קישורים במסמכי HTML. אף אחד לא עוזב
mailto: קישורים כפי שהם. javascript מערפל אותם באמצעות javascript.
הפניות מטשטשות אותן על ידי הדפסת האותיות שלהן כעשרוניות או הקסדצימליות
התייחסויות לדמויות. ברירת המחדל היא javascript.

--id-prefix=STRING
ציין קידומת שתתווסף לכל המזהים שנוצרו אוטומטית ב-HTML ו
פלט DocBook, ולמספרי הערות שוליים בפלט Markdown. זה שימושי עבור
מניעת כפילויות של מזהים בעת יצירת פרגמנטים שייכללו באחר
דפים.

-T STRING, --title-prefix=STRING
לפרט STRING בתור קידומת בתחילת הכותרת המופיעה ב-HTML
header (אך לא בכותרת כפי שהיא מופיעה בתחילת גוף ה-HTML).
מרמז על - עצמאי.

-c כתובת האתר, --css=כתובת האתר
קישור לגיליון סגנונות CSS. ניתן להשתמש באפשרות זו שוב ושוב כדי לכלול
קבצים מרובים. הם ייכללו בסדר שצוין.

--reference-odt=קובץ
השתמש בקובץ שצוין כהפניה לסגנון בהפקת ODT. לקבלת התוצאות הטובות ביותר,
ההפניה ODT צריכה להיות גרסה שונה של ODT המיוצר באמצעות Pandoc.
מתעלמים מהתוכן של הפניה ODT, אבל גיליונות הסגנונות שלו משמשים ב-
ODT חדש. אם לא צוין התייחסות ODT בשורת הפקודה, Pandoc ייראה
עבור קובץ reference.odt בספריית נתוני המשתמש (ראה --data-dir). אם זה
גם לא נמצא, ייעשה שימוש בברירות מחדל הגיוניות.

--reference-docx=קובץ
השתמש בקובץ שצוין כהפניה לסגנון בהפקת קובץ docx. לטובה
תוצאות, ה-Reference docx צריך להיות גרסה שונה של קובץ docx שהופק
באמצעות pandoc. מתעלמים מהתוכן של ה-Reference docx, אבל גיליונות הסגנונות שלו
ומאפייני מסמך (כולל שוליים, גודל עמוד, כותרת עליונה וכותרת תחתונה) משמשים
ב-docx החדש. אם לא צוין docx עזר בשורת הפקודה, pandoc
יחפש קובץ reference.docx בספריית נתוני המשתמש (ראה --data-dir).
אם גם זה לא יימצא, ייעשה שימוש בברירות מחדל הגיוניות. הסגנונות הבאים
נמצאים בשימוש על ידי Pandoc: [פסקה] רגילה, טקסט גוף, פסקה ראשונה, קומפקטית, כותרת,
כותרת משנה, מחבר, תאריך, תקציר, ביבליוגרפיה, כותרת 1, כותרת 2, כותרת 3,
כותרת 4, כותרת 5, כותרת 6, טקסט בלוק, טקסט של הערת שוליים, מונח הגדרה,
הגדרה, כיתוב, כיתוב טבלה, כיתוב תמונה, איור, איור עם כיתוב, TOC
כּוֹתֶרֶת; [תו] גופן פסקה ברירת מחדל, תו טקסט גוף, תו מילולי,
הפניה להערת שוליים, היפר-קישור; [טבלה] טבלה רגילה.

--epub-stylesheet=קובץ
השתמש בקובץ ה-CSS שצוין כדי לסגנן את ה-EPUB. אם לא צוין גיליון סגנונות,
pandoc יחפש קובץ epub.css בספריית נתוני המשתמש (ראה --data-dir).
אם הוא לא נמצא שם, ייעשה שימוש בברירות מחדל הגיוניות.

--epub-cover-image=קובץ
השתמש בתמונה שצוינה ככריכת EPUB. מומלץ שהתמונה תהיה
פחות מ-1000 פיקסלים ברוחב ובגובה. שימו לב שבמסמך מקור של Markdown אתם
יכול גם לציין תמונת שער בבלוק מטא נתונים של YAML (ראה מטא נתונים של EPUB, להלן).

--epub-metadata=קובץ
חפש בקובץ ה-XML שצוין מטא נתונים עבור ה-EPUB. הקובץ צריך להכיל
סדרה של אלמנטים ליבה של דבלין. לדוגמה:

קריאייטיב קומונס
es-AR

כברירת מחדל, Pandoc יכלול את רכיבי המטא נתונים הבאים: (מ
כותרת המסמך), (ממחברי המסמך), (מ ה
תאריך המסמך, שצריך להיות בפורמט ISO 8601), (מהלאנג
משתנה, או, אם לא מוגדר, המקום), ו (א
UUID שנוצר באופן אקראי). כל אחד מאלה עשוי להיות עוקף על ידי אלמנטים ב-
קובץ מטא נתונים.

הערה: אם מסמך המקור הוא Markdown, בלוק מטא נתונים של YAML במסמך יכול
לשמש במקום. ראה למטה תחת מטא נתונים של EPUB.

--epub-embed-font=קובץ
הטמע את הגופן שצוין ב-EPUB. ניתן לחזור על אפשרות זו להטמעה
מספר גופנים. ניתן להשתמש גם בתווים כלליים: לדוגמה, DejaVuSans-*.ttf.
עם זאת, אם אתה משתמש בתווים כלליים בשורת הפקודה, הקפד לברוח מהם או לשים
את כל שם הקובץ במרכאות בודדות, כדי למנוע מהם להתפרש על ידי ה-
צדף. כדי להשתמש בגופנים המוטבעים, תצטרך להוסיף הצהרות כמו ה
הבא ל-CSS שלך (ראה --epub-stylesheet):

@סוג גופן {
font-family: DejaVuSans;
סגנון פונט: רגיל;
משקל גופן: רגיל;
src:url("DejaVuSans-Regular.ttf");
}
@סוג גופן {
font-family: DejaVuSans;
סגנון פונט: רגיל;
מודגש;
src:url("DejaVuSans-Bold.ttf");
}
@סוג גופן {
font-family: DejaVuSans;
סגנון גופן: נטוי;
משקל גופן: רגיל;
src:url("DejaVuSans-Oblique.ttf");
}
@סוג גופן {
font-family: DejaVuSans;
סגנון גופן: נטוי;
מודגש;
src:url("DejaVuSans-BoldOblique.ttf");
}
body { font-family: "DejaVuSans"; }

--epub-chapter-level=מספר
ציין את רמת הכותרת שבה לפצל את ה-EPUB לקבצי "פרק" נפרדים.
ברירת המחדל היא להתפצל לפרקים בכותרות ברמה 1. אפשרות זו משפיעה רק
ההרכב הפנימי של ה-EPUB, לא כמו הפרקים והקטעים
מוצג למשתמשים. חלק מהקוראים עשויים להיות איטיים אם קבצי הפרקים גדולים מדי,
אז עבור מסמכים גדולים עם מעט כותרות ברמה 1, אולי כדאי להשתמש בפרק
רמה של 2 או 3.

--latex-engine=pdflatex|lualatex|xelatex
השתמש במנוע ה-LaTeX שצוין בעת ​​הפקת פלט PDF. ברירת המחדל היא pdflatex.
אם המנוע אינו ב-PATH שלך, ייתכן שיצוין הנתיב המלא של המנוע
כאן.

--latex-engine-opt=STRING
השתמש במחרוזת הנתונה כארגומנט שורת פקודה למנוע הלטקס. אם נעשה שימוש
מספר פעמים, הטיעונים מסופקים עם רווחים ביניהם. שימו לב שלא
בדיקת אפשרויות כפולות מתבצעת.

צִיטָטָה טיוח
--ביבליוגרפיה=קובץ
הגדר את שדה הביבליוגרפיה במטא נתונים של המסמך ל קובץ, עוקף כל ערך
להגדיר במטא נתונים, ולעבד ציטוטים באמצעות pandoc-citeproc. (זה
שווה ערך ל --metadata bibliography=FILE --filter pandoc-citeproc.) אם --natbib
או --biblatex מסופק גם, Pandoc-citeproc אינו בשימוש, מה שהופך את זה לשווה ערך
אל --metadata bibliography=FILE. אם אתה מספק טיעון זה מספר פעמים, כל אחת
קובץ יתווסף לביבליוגרפיה.

--csl=קובץ
הגדר את שדה csl במטא נתונים של המסמך ל קובץ, עוקף כל ערך שהוגדר
המטא נתונים. (זה שווה ערך ל--metadata csl=FILE.) אפשרות זו היא בלבד
רלוונטי עם pandoc-citeproc.

--ציטוט-קיצורים=קובץ
הגדר את שדה ציטוט-קיצורים במטא נתונים של המסמך ל קובץ, דריסה
כל ערך שהוגדר במטא נתונים. (זה שווה ערך ל
--metadata citation-abbreviations=FILE.) אפשרות זו רלוונטית רק עם
pandoc-citeproc.

--נטביב
השתמש ב-natbib לציטוטים בפלט LaTeX. אפשרות זו אינה לשימוש עם
מסנן pandoc-citeproc או עם פלט PDF. הוא מיועד לשימוש בייצור א
קובץ LaTeX שניתן לעבד עם bibtex.

--biblatex
השתמש ב-biblatex עבור ציטוטים בפלט LaTeX. אפשרות זו אינה לשימוש עם
מסנן pandoc-citeproc או עם פלט PDF. הוא מיועד לשימוש בייצור א
קובץ LaTeX שניתן לעבד עם bibtex או biber.

מתמטיקה טיוח in HTML
-m [כתובת האתר], --latexmathml[=כתובת האתר]
השתמש ב-LaTeXMathML כדי להציג מתמטיקה משובצת של TeX בפלט HTML. ה כתובת האתר צריך להצביע
לסקריפט הטעינה של LaTeXMathML.js. אם כתובת האתר לא מסופק, קישור אל
LaTeXMathML.js בדף הבית של LaTeXMathML יוכנס.

--mathml[=כתובת האתר]
המרת TeX מתמטיקה ל- MathML (ב-docbook כמו גם ב-html וב-html5). במצב עצמאי
פלט html, javascript קטן (או קישור לסקריפט כזה אם א כתובת האתר מסופק)
יוכנס המאפשר צפייה ב- MathML בדפדפנים מסוימים.

--jsmath[=כתובת האתר]
השתמש ב-jsMath כדי להציג מתמטיקה משובצת של TeX בפלט HTML. ה כתובת האתר צריך להצביע על
סקריפט הטעינה jsMath (למשל jsMath/easy/load.js); אם יסופק, זה יהיה מקושר
בכותרת של מסמכי HTML עצמאיים. אם כתובת האתר לא מסופק, אין קישור
לסקריפט הטעינה jsMath יוכנס; אז זה תלוי במחבר לספק
קישור כזה בתבנית HTML.

--mathjax[=כתובת האתר]
השתמש ב- MathJax כדי להציג מתמטיקה משובצת של TeX בפלט HTML. ה כתובת האתר צריך להצביע על
סקריפט הטעינה MathJax.js. אם כתובת האתר לא מסופק, קישור ל- MathJax CDN
יוכנס.

--גלדטקס
צירוף מתמטיקה של TeX תגיות בפלט HTML. לאחר מכן ניתן לעבד אותם על ידי
gladTeX להפקת קישורים לתמונות של הנוסחאות.

--mimetex[=כתובת האתר]
עבד מתמטיקה של TeX באמצעות סקריפט mimeTeX CGI. אם כתובת האתר לא מצוין, זה כן
ההנחה שהסקריפט נמצא ב-/cgi-bin/mimetex.cgi.

--webtex[=כתובת האתר]
עיבוד נוסחאות TeX באמצעות סקריפט חיצוני הממיר נוסחאות TeX לתמונות.
הנוסחה תשורשר לכתובת ה-URL שסופקה. אם כתובת האתר לא מצוין,
ייעשה שימוש ב-Google Chart API.

--katex[=כתובת האתר]
השתמש ב-KaTeX כדי להציג מתמטיקה משובצת של TeX בפלט HTML. ה כתובת האתר צריך להצביע על
סקריפט טעינת katex.js. אם כתובת האתר לא מסופק, קישור ל-CDN של KaTeX יהיה
מוּכנָס.

--katex-stylesheet=כתובת האתר
השמיים כתובת האתר צריך להצביע על גיליון הסגנונות katex.css. אם אפשרות זו לא צוינה,
קישור ל-CDN של KaTeX יוכנס. שים לב שאופציה זו אינה מרמזת
--קטקס.

אפשרויות ל עֲטִיפָה סקריפטים
--dump-args
הדפס מידע על ארגומנטים של שורת הפקודה ל stdout, ואז צא. אפשרות זו
מיועד בעיקר לשימוש בסקריפט עטיפה. שורת הפלט הראשונה
מכיל את השם של קובץ הפלט שצוין עם האפשרות -o, או - (עבור
stdout) אם לא צוין קובץ פלט. השורות הנותרות מכילות את
ארגומנטים של שורת הפקודה, אחד בכל שורה, לפי סדר הופעתם. אלה לא
כלול אפשרויות פנדוק רגילות והטיעונים שלהן, אך כלול אפשרויות כלשהן
מופיע אחרי מפריד -- בסוף השורה.

--תעלם-ארגס
התעלם מארגומנטים של שורת הפקודה (לשימוש בסקריפטים של עטיפה). אפשרויות פנדוק רגילות
לא מתעלמים. כך, למשל,

pandoc --ignore-args -o foo.html -s foo.txt -- -e latin1

שווה

pandoc -o foo.html -s

TEMPLATES

כאשר נעשה שימוש באפשרות העצמאית -s/--, Pandoc משתמש בתבנית כדי להוסיף כותרת עליונה ותחתונה
חומר הדרוש למסמך העומד בפני עצמו. כדי לראות את תבנית ברירת המחדל כלומר
בשימוש, פשוט הקלד

pandoc -D *פורמט*

איפה פורמט הוא השם של פורמט הפלט. ניתן לציין תבנית מותאמת אישית באמצעות
אפשרות --template. אתה יכול גם לעקוף את תבניות ברירת המחדל של המערכת עבור נתון
פורמט פלט פורמט על ידי הכנסת קובץ תבניות/ברירת מחדל.*FORMAT* בנתוני המשתמש
ספרייה (ראה --data-dir, למעלה). חריגים: עבור פלט odt, התאם אישית את
default.opendocument תבנית. עבור פלט PDF, התאם אישית את תבנית default.latex.

תבניות מכילות משתנים, המאפשרים הכללת מידע שרירותי בכל
נקודה בקובץ. ניתן להגדיר משתנים בתוך המסמך באמצעות בלוקים של מטא נתונים של YAML.
ניתן להגדיר אותם גם בשורת הפקודה באמצעות האפשרות -V/--variable: משתנים מוגדרים
בדרך זו לעקוף שדות מטא נתונים עם אותו שם.

משתנים סט by פנדוק
משתנים מסוימים מוגדרים אוטומטית על ידי Pandoc. אלה משתנים במידה מסוימת בהתאם ל
פורמט פלט, אך כלול שדות מטא נתונים וכן את הדברים הבאים:

כותרת, מְחַבֵּר, נתונים
לאפשר זיהוי של היבטים בסיסיים של המסמך. כלול במטא נתונים של PDF
דרך LaTeX ו-ConTeXt. ניתן להגדיר אותם באמצעות בלוק כותרת של Pandoc, אשר
מאפשר מספר מחברים, או באמצעות בלוק מטא נתונים של YAML:

---
מְחַבֵּר:
- אריסטו
- פיטר אבלארד
...

כתובית
כתובית מסמך, כלולה ב-HTML, EPUB, LaTeX, ConTeXt ו- Word docx; מעבד
ב-LaTeX רק בעת שימוש במחלקת מסמכים התומכת ב-\subtitle, כגון beamer
או סדרת KOMA-Script (scratcl, scrreprt, scrbook).

תַקצִיר
סיכום מסמך, כלול ב-LaTeX, ConTeXt, AsciiDoc ו- Word docx

מילות מפתח
רשימה של מילות מפתח שייכללו במטא נתונים של HTML, PDF ו-AsciiDoc; אולי
חזר על המחבר, לעיל

כותרת-כוללת
תוכן שצוין על ידי -H/--include-in-header (יכול להיות בעל מספר ערכים)

ט.ק. ערך שאינו ריק אם צוין --toc/--table-of-contents

טוק-כותרת
כותרת תוכן העניינים (עובד רק עם EPUB ו-docx)

כוללים-לפני
תוכן שצוין על ידי -B/--include-before-body (ייתכן שיש לו ערכים מרובים)

כוללים-אחרי
תוכן שצוין על ידי -A/--include-after-body (יכול להיות בעל מספר ערכים)

גוּף גוף המסמך

meta-json
ייצוג JSON של כל המטא נתונים של המסמך

שפה משתנים
lang מזהה את השפה הראשית של המסמך, באמצעות קוד לפי BCP 47
(למשל en או en-GB). עבור פורמטים מסוימים של פלט, Pandoc ימיר אותו ל-an
פורמט מתאים המאוחסן במשתנים הנוספים babel-lang, polyglossia-lang
(LaTeX) ו-context-lang (ConTeXt).

ניתן להשתמש בטווחי Pandoc ו-divs מקוריים עם תכונת lang (ערך ב-BCP 47)
כדי להחליף את השפה בטווח זה.

שפות אחרות
רשימה של שפות אחרות בשימוש במסמך במטא נתונים של YAML, לפי
BCP 47. לדוגמה: otherlangs: [en-GB, fr]. זה נוצר באופן אוטומטי
מתכונות lang בכל הטווחים והדיסקים, אך ניתן לעקוף אותם. כַּיוֹם
בשימוש רק על ידי LaTeX דרך Babel-otherlangs שנוצרו ו
משתני polyglossia-otherlangs. כותב LaTeX מוציא פקודות polyglossia ב
הטקסט אבל המשתנה babel-newcommands מכיל מיפויים עבורם ל-
בבל המקביל.

dir כיוון הבסיס של המסמך, rtl (מימין לשמאל) או ltr
(משמאל לימין).

עבור מסמכים דו-כיווניים, טווחי Pandoc ו-divs מקוריים עם התכונה dir
(ערך rtl או ltr) ניתן להשתמש כדי לעקוף את כיוון הבסיס בפלט כלשהו
פורמטים. זה לא תמיד נחוץ אם המעבד הסופי (למשל ה
הדפדפן, בעת יצירת HTML) תומך באלגוריתם דו-כיווני Unicode.

בעת שימוש ב-LaTeX עבור מסמכים דו-כיווניים, רק מנוע ה-xelatex מלא
נתמך (השתמש ב--latex-engine=xelatex).

משתנים ל שקופיות
משתנים זמינים להפקת הצגת שקופיות עם Pandoc, כולל כל reveal.js
אפשרויות תצורה.

slidy-url
כתובת URL בסיסית עבור מסמכי Slidy (ברירת המחדל היא http://www.w3.org/Talks/Tools/Slidy2)

slideous-url
כתובת URL בסיסית עבור מסמכי Slideous (ברירת המחדל היא slideous)

s5-url כתובת URL בסיסית עבור מסמכי S5 (ברירת המחדל היא s5/ברירת מחדל)

revealjs-url
כתובת אתר בסיסית למסמכי reveal.js (ברירת המחדל היא reveal.js)

נושא, נושא צבע, נושא גופן, נושא פנימי, נושא חיצוני
ערכות נושא עבור מסמכי beamer LaTeX

שיט
שולט בסמלי ניווט במסמכי beamer (ברירת המחדל ריקה ללא ניווט
סמלים; ערכים חוקיים אחרים הם מסגרת, אנכית ואופקית).

כותרות מדור
מאפשר ב"עמודי שער" עבור קטעים חדשים במסמכי beamer (ברירת מחדל = true).

משתנים ל LaTeX
משתני LaTeX משמשים בעת יצירת PDF.

גודל נייר
גודל נייר, למשל Letter, A4

גודל גופן
גודל גופן עבור גוף טקסט (למשל 10 נק', 12 נק')

כיתת מסמכים
כיתת מסמכים, למשל מאמר, דוח, ספר, ספר זיכרונות

אפשרות כיתה
אפשרות למחלקת מסמכים, למשל oneside; עשוי לחזור על מספר אפשרויות

גאומטריה
אפשרות לחבילת גיאומטריה, למשל margin=1in; עשוי לחזור על מספר אפשרויות

שוליים-שמאליים, שוליים-ימין, שוליים למעלה, שולי תחתית
מגדיר שוליים, אם לא נעשה שימוש בגיאומטריה (אחרת הגיאומטריה עוקפת אותם)

מתיחת קווים
מתאים את מרווח השורות באמצעות חבילת setspace, למשל 1.25, 1.5

משפחת גופן
חבילת גופנים לשימוש עם pdflatex: TeX Live כוללת אפשרויות רבות, מתועדות ב
קטלוג הגופנים של LaTeX. ברירת המחדל היא Latin Modern.

אפשרויות fontfamily
אפשרויות לחבילה המשמשת כ-fontfamily: למשל osf,sc עם fontfamily מוגדר ל
mathpazo מספק לפאלאטינו דמויות בסגנון ישן וכותרות קטנות אמיתיות; אולי
חוזר על מספר אפשרויות

mainfont, סנפונט, מונופונט, Mathfont, CJKmainfont
משפחות גופנים לשימוש עם xelatex או lualatex: קח את השם של כל גופן מערכת,
באמצעות חבילת fontspec. שימו לב שאם נעשה שימוש ב-CJKmainfont, החבילה xecjk
חייב להיות זמין.

mainfontoptions, סנפונטאופציות, מונופונטאופציות, אפשרויות מתמטיקה, CJKoptions
אפשרויות לשימוש עם mainfont, sansfont, monofont, mathfont, CJKmainfont ב-xelatex
ולואלטקס. אפשר כל בחירה הזמינה דרך fontspec, כגון
OpenType features Numbers=OldStyle,Numbers=Proportional. ניתן לחזור על
אפשרויות מרובות.

פונטנק
מאפשר לציין קידוד גופנים באמצעות חבילת fontenc (עם pdflatex);
ברירת המחדל היא T1 (ראה מדריך לקידוד גופני LaTeX)

קישורי צבע
הוסף צבע לטקסט הקישור; מופעלת אוטומטית אם כל אחד מ-linkcolor, citecolor,
urlcolor, או toccolor מוגדרים

צבע קישור, citecolor, urlcolor, טוקולור
צבע עבור קישורים פנימיים, קישורי ציטוט, קישורים חיצוניים וקישורים בטבלה של
תוכן: משתמש בכל אחד מצבעי ה-LaTeX המוגדרים מראש

קישורים כהערות
גורם להדפסת קישורים כהערות שוליים

לְשַׁנֵן משתמש בהגדרות מחלקות מסמכים עבור הזחה (תבנית ברירת המחדל של LaTeX אחרת
מסיר הזחה ומוסיף רווח בין פסקאות)

סעיף משנה
משבית את התנהגות ברירת המחדל של תבנית LaTeX המגדירה מחדש פסקאות (משנה) כ
מקטעים, שינוי המראה של כותרות מקוננות במחלקות מסוימות

תודה מציין את התוכן של הערת שוליים תודות לאחר כותרת המסמך.

ט.ק. כולל תוכן עניינים (ניתן להגדיר גם באמצעות --toc/--table-of-content)

עומק טוק
רמת הסעיף שיש לכלול בתוכן העניינים

לוף, מגרש
כולל רשימה של דמויות, רשימה של טבלאות

ביבליוגרפיה
ביבליוגרפיה לשימוש לפתרון הפניות

בסגנון ביבליו
סגנון ביבליוגרפיה, בשימוש עם --natbib ו --biblatex.

biblatexoptions
רשימה של אפשרויות עבור biblatex.

משתנים ל הֶקשֵׁר
גודל נייר
גודל נייר, למשל Letter, A4, לרוחב (ראה ConTeXt Paper Setup); עשוי לחזור על עצמו
עבור אפשרויות מרובות

פריסה אפשרויות לשולי עמוד וסידור טקסט (ראה פריסת ConTeXt); עשוי לחזור על עצמו
עבור אפשרויות מרובות

שוליים-שמאליים, שוליים-ימין, שוליים למעלה, שולי תחתית
מגדיר שוליים, אם לא נעשה שימוש בפריסה (אחרת הפריסה עוקפת אותם)

גודל גופן
גודל גופן עבור גוף טקסט (למשל 10 נק', 12 נק')

mainfont, סנפונט, מונופונט, Mathfont
משפחות גופנים: קח את השם של כל גופן מערכת (ראה החלפת גופנים ConTeXt)

צבע קישור, צבע ניגודי
צבע עבור קישורים מחוץ ובתוך דף, למשל אדום, כחול (ראה ConTeXt Color)

סגנון קישור
סגנון גופן לקישורים, למשל רגיל, מודגש, מלוכסן, מודגש, סוג, כובע,
קטן

כניסה
שולט בהזחה של פסקאות, למשל yes,small,next (ראה ConTeXt Indentation);
עשוי לחזור על מספר אפשרויות

מרחב לבן
מרווח בין פסקאות, למשל ללא, קטן (שימוש ב-setupwhitespace)

מרחב בין קווים
מתאים את מרווח השורות, למשל 4ex (באמצעות setupinterlinespace); עשוי לחזור על עצמו עבור
אפשרויות מרובות

טקסט כותרת, טקסט תחתון
טקסט שיוצב בכותרת עליונה או תחתונה רצים (ראה כותרות ותחתונות ConTeXt);
ניתן לחזור על עצמו עד ארבע פעמים עבור מיקום שונה

מספור עמודים
סגנון ומיקום מספר עמוד (באמצעות setuppagenumbering); עשוי לחזור על עצמו עבור
אפשרויות מרובות

ט.ק. כולל תוכן עניינים (ניתן להגדיר גם באמצעות --toc/--table-of-content)

לוף, מגרש
כולל רשימה של דמויות, רשימה של טבלאות

משתנים ל איש דפים
סעיף
מספר סעיף בדפי אדם

כותרת כותרת בדפי אדם

תחתון כותרת תחתונה בדפי אדם

התאמה
מתאים את הטקסט לשוליים שמאלה (l), ימין (r), מרכז (c), או לשניהם (ב).

לְמַקֵף
אם נכון (ברירת המחדל), ייעשה שימוש במיקוף

שימוש משתנים in תבניות
שמות משתנים הם רצפים של אלפאנומריה, -, ו-_, המתחילים באות. א
שם המשתנה מוקף בסימני $ יוחלף בערכו. לדוגמה, ה
מחרוזת $title$ ב

$title$

יוחלף בכותרת המסמך.

כדי לכתוב $ מילולי בתבנית, השתמש ב-$$.

תבניות עשויות להכיל תנאים. התחביר הוא כדלקמן:

$if(משתנה)$
X
$אחר$
Y
$endif$

זה יכלול X בתבנית אם למשתנה יש ערך שאינו ריק; אחרת זה יקרה
include Y. X ו-Y הם מצייני מיקום עבור כל טקסט תבנית חוקי, ועשויים לכלול
משתנים משולבים או תנאים אחרים. ניתן להשמיט את הקטע $else$.

כאשר למשתנים יכולים להיות ערכים מרובים (לדוגמה, מחבר במסמך מרובה מחברים),
אתה יכול להשתמש במילת המפתח $for$:

$for(author)$

$endfor$

ניתן לציין אופציונלי מפריד לשימוש בין פריטים עוקבים:

$for(author)$$author$$sep$, $endfor$

ניתן להשתמש בנקודה כדי לבחור שדה של משתנה שלוקח אובייקט כערך שלו. כך,
לדוגמה:

$author.name$ ($author.affiliation$)

אם אתה משתמש בתבניות מותאמות אישית, ייתכן שיהיה עליך לשנות אותן כשינויים ב-pandoc. אנחנו ממליצים
מעקב אחר השינויים בתבניות ברירת המחדל ושינוי התבניות המותאמות אישית שלך
בהתאם לכך. דרך קלה לעשות זאת היא לחלק את מאגר תבניות ה-pandoc ולמזג
בשינויים לאחר כל שחרור פאנדוק.

PANDOC'S MARKDOWN

פנדוק מבין גרסה מורחבת ומתוקנת מעט של Markdown של ג'ון גרובר
תחביר. מסמך זה מסביר את התחביר, מציין הבדלים מ-Markdown הסטנדרטי.
למעט היכן שצוין, ניתן לדכא את ההבדלים הללו על ידי שימוש ב-markdown_strict
פורמט במקום סימון. ניתן להפעיל הרחבות על ידי הוספת +EXTENSION ל-
פורמט שם ומושבת על ידי הוספת -EXTENSION. לדוגמה, markdown_strict+הערות שוליים הוא
Markdown קפדני עם הערות שוליים מופעלות, בעוד ש-markdown-footnotes-pipe_tables הוא Pandoc's
סימון ללא הערות שוליים או טבלאות צינור.

פִילוֹסוֹפִיָה
Markdown נועד להיות קל לכתיבה, ועוד יותר חשוב, קל לקריאה:

מסמך בפורמט Markdown צריך להיות ניתן לפרסום כפי שהוא, כטקסט רגיל, ללא
נראה כאילו הוא סומן בתגים או הוראות עיצוב. -- ג'ון
גרובר

עיקרון זה הנחה את ההחלטות של Pandoc במציאת תחביר לטבלאות, הערות שוליים ו
הרחבות אחרות.

עם זאת, יש במובן אחד שבו מטרותיו של פאנדוק שונות מהמטרות המקוריות
של Markdown. בעוד Markdown תוכנן במקור עם מחשבה על יצירת HTML,
pandoc מיועד לפורמטי פלט מרובים. כך, בעוד Pandoc מאפשר את ההטמעה
של HTML גולמי, הוא מייאש אותו, ומספק דרכים אחרות, שאינן HTMLish, לייצוג
רכיבי מסמך חשובים כמו רשימות הגדרות, טבלאות, מתמטיקה והערות שוליים.

פסקאות
פסקה היא שורה אחת או יותר של טקסט ואחריה שורה אחת או יותר ריקות. שורות חדשות
מתייחסים כרווחים, כך שתוכל להזרים את הפסקאות שלך כרצונך. אם אתה צריך קשה
מעבר שורה, שים שני רווחים או יותר בסוף שורה.

סיומת: escaped_line_breaks
נטוי אחורי ואחריו קו חדש הוא גם שבירת קו קשה. הערה: ברב-קו וברשת
תאי טבלה, זו הדרך היחידה ליצור מעבר קו קשיח, שכן רווחים נגררים פנימה
מתעלמים מהתאים.

כותרות
ישנם שני סוגים של כותרות: Setext ו-ATX.

בסגנון סטקסט כותרות
כותרת בסגנון setext היא שורת טקסט "מסומנת בקו תחתון" עם שורה של סימני = (עבור רמה
כותרת אחת) או - סימנים (עבור כותרת רמה שתיים):

כותרת רמה אחת
==================

כותרת רמה שתיים
------------------

טקסט הכותרת יכול להכיל עיצוב מוטבע, כגון הדגשה (ראה עיצוב מוטבע,
להלן).

בסגנון ATX כותרות
כותרת בסגנון ATX מורכבת מאחד עד שישה סימן # ושורת טקסט, לאחר מכן
לפי כל מספר של # סימנים. מספר הסימנים # בתחילת השורה הוא
רמת כותרת:

## כותרת רמה שתיים

### כותרת רמה שלוש ###

כמו בכותרות בסגנון setext, טקסט הכותרת יכול להכיל עיצוב:

# כותרת ברמה אחת עם [קישור](/url) ו-*דגש*

סיומת: blank_before_header
תחביר Markdown סטנדרטי אינו דורש שורה ריקה לפני כותרת. פנדוק כן
דורשים זאת (למעט, כמובן, בתחילת המסמך). הסיבה ל
הדרישה היא שקל מדי ש-# יסתיים בתחילת שורה לפי
תאונה (אולי דרך גלישת קו). קחו למשל:

אני אוהב כמה מהטעמים של הגלידה שלהם:
#22, למשל, ו-#5.

כותרת מזהים
סיומת: header_attributes
ניתן להקצות לכותרות תכונות באמצעות תחביר זה בסוף השורה המכילה את
טקסט כותרת:

{#identifier .class .class key=value key=value}

כך, למשל, לכותרות הבאות כולן יוקצו המזהה foo:

# הכותרת שלי {#foo}

## הכותרת שלי ## {#foo}

הכותרת האחרת שלי {#foo}
---------------

(תחביר זה תואם ל-PHP Markdown Extra.)

שימו לב שלמרות שהתחביר הזה מאפשר הקצאת מחלקות ותכונות מפתח/ערך,
סופרים בדרך כלל לא משתמשים בכל המידע הזה. מזהים, מחלקות ומפתח/ערך
תכונות משמשות בפורמטים מבוססי HTML ו-HTML כגון EPUB ו-slidy. מזהים
משמשים עבור תוויות ועוגני קישור בכותבי LaTeX, ConTeXt, Textile ו- AsciiDoc.

כותרות עם המחלקה ללא מספרים לא יספרו, גם אם --number-sections כן
נָקוּב. מקף בודד (-) בהקשר של תכונה שווה ערך ל-.unnumbered, ו
עדיף במסמכים שאינם באנגלית. כך,

# הכותרת שלי {-}

הוא בדיוק כמו

# הכותרת שלי {.unnumbered}

סיומת: מזהים_אוטומטיים
כותרת ללא מזהה שצוין במפורש תוקצה באופן אוטומטי א
מזהה ייחודי המבוסס על טקסט הכותרת. כדי לגזור את המזהה מהכותרת
טקסט,

· הסר את כל העיצוב, הקישורים וכו'.

· הסר את כל הערות השוליים.

· הסר את כל סימני הפיסוק, למעט קווים תחתונים, מקפים ונקודות.

· החלף את כל הרווחים והשורות החדשות במקפים.

· המר את כל התווים האלפביתיים לאותיות קטנות.

· הסר הכל עד האות הראשונה (ייתכן שמזהים לא מתחילים במספר או
סימן פיסוק).

· אם לא נשאר דבר לאחר מכן, השתמש בסעיף המזהה.

כך, למשל,

מזהה כותרת
────────────────────────────────────────────────── ──────
מזהי כותרות ב-HTML header-identifiers-in-html
*כלבים*?--בבית *שלי*? כלבים--בבית-שלי
[HTML], [S5], או [RTF]? html-s5-or-rtf
3. יישומים יישומים
קטע 33

כללים אלה צריכים, ברוב המקרים, לאפשר לקבוע את המזהה מהכותרת
טֶקסט. היוצא מן הכלל הוא כאשר למספר כותרות יש את אותו טקסט; במקרה זה, הראשון
יקבל מזהה כמתואר לעיל; השני יקבל את אותו מזהה עם -1
מצורף; השלישי עם -2; וכולי.

המזהים האלה משמשים כדי לספק יעדי קישור בתוכן העניינים שנוצר על ידי
האפשרות --toc|--table-of-content. הם גם מקלים על מתן קישורים מאחד
קטע של מסמך לאחר. קישור לקטע הזה, למשל, עשוי להיראות כך
זֶה:

עיין בסעיף בנושא
[מזהי כותרת](#header-identifiers-in-html-latex-and-context).

שים לב, עם זאת, שיטה זו של מתן קישורים לקטעים פועלת רק ב-HTML, LaTeX,
ופורמטים ConTeXt.

אם האופציה --section-divs מצוינת, אז כל קטע יהיה עטוף ב-div (או
קטע, אם --html5 צוין), והמזהה יצורף למצורף
(אוֹ ) תג במקום הכותרת עצמה. זה מאפשר חלקים שלמים להיות
מטופל באמצעות javascript או מטופל אחרת ב-CSS.

סיומת: implicit_header_references
Pandoc מתנהג כאילו הוגדרו קישורי עזר לכל כותרת. אז, במקום

[מזהי כותרת](#header-identifiers-in-html)

אתה יכול פשוט לכתוב

[מזהי כותרת]

or

[מזהי כותרות][]

or

[הקטע על מזהי כותרות][מזהי כותרת]

אם יש מספר כותרות עם טקסט זהה, ההפניה המתאימה תקשר
לראשון בלבד, ותצטרך להשתמש בקישורים מפורשים כדי לקשר אל האחרים, כמו
מתואר לעיל.

כמו קישורי הפניות רגילים, הפניות אלו אינן תלויות רישיות.

הגדרות הפניות מפורשות של קישורים תמיד מקבלות עדיפות על פני הפניות כותרות מרומזות.
אז, בדוגמה הבאה, הקישור יפנה לסרגל, לא ל-#foo:

# פו

[פו בר

ראה [foo]

לחסום ציטוטים
Markdown משתמש במוסכמות דוא"ל לציטוט בלוקים של טקסט. ציטוט בלוק הוא אחד או
יותר פסקאות או רכיבי בלוק אחרים (כגון רשימות או כותרות), עם כל שורה
לפניו תו > ורווח אופציונלי. (ה-> לא צריך להתחיל משמאל
שוליים, אך אין להכניס אותו יותר משלושה רווחים.)

> זהו ציטוט בלוק. זֶה
> לפסקה יש שתי שורות.
>
> 1. זוהי רשימה בתוך ציטוט בלוק.
> 2. פריט שני.

טופס "עצלן", המחייב את התו > רק בשורה הראשונה של כל בלוק, הוא
מותר גם:

> זהו ציטוט בלוק. זֶה
לפסקה יש שתי שורות.

> 1. זוהי רשימה בתוך ציטוט בלוק.
2. פריט שני.

בין רכיבי הבלוק שניתן להכיל במרכאות בלוקים ישנן מרכאות בלוק אחרות.
כלומר, ניתן לקנן מרכאות בלוקים:

> זהו ציטוט בלוק.
>
> > ציטוט בלוק בתוך ציטוט בלוק.

אם אחרי התו > מופיע רווח אופציונלי, הרווח הזה ייחשב כחלק ממנו
סמן המרכאות הבלוק ולא חלק מההזחה של התוכן. לפיכך, לשים א
בלוק קוד מוזח במירכאת בלוק, אתה צריך חמישה רווחים אחרי >:

> קוד

סיומת: blank_before_blockquote
תחביר Markdown סטנדרטי אינו דורש שורה ריקה לפני ציטוט בלוק. פנדוק כן
דורשים זאת (למעט, כמובן, בתחילת המסמך). הסיבה ל
הדרישה היא שקל מדי ל-> להיגמר בתחילת שורה ליד
תאונה (אולי דרך גלישת קו). אז, אלא אם נעשה שימוש בפורמט markdown_strict,
הדברים הבאים אינם מייצרים ציטוט בלוק מקונן ב-pandoc:

> זהו ציטוט בלוק.
>> מקונן.

מִלָה בְּמִלָה (קוד) אבני
מְסוּכסָך קוד אבני
גוש טקסט שהוכנס לארבעה רווחים (או טאב אחד) מטופל כטקסט מילולי: כלומר,
תווים מיוחדים אינם מפעילים עיצוב מיוחד, וכל הרווחים ומעברי השורות כן
השתמר. לדוגמה,

if (a > 3) {
moveShip(5 * כוח המשיכה, DOWN);
}

ההזחה הראשונית (ארבעה רווחים או טאבים אחת) אינה נחשבת כחלק מהמילה מילה במילה
טקסט, ומוסר בפלט.

הערה: שורות ריקות בטקסט המילולי אינן חייבות להתחיל בארבעה רווחים.

מְגוּדָר קוד אבני
סיומת: חסימות_קוד_מגודרות
בנוסף לבלוקים סטנדרטיים של קוד מרווח, Pandoc תומך מְגוּדָר בלוקי קוד. אלה
מתחילים בשורה של שלוש טילדות או יותר (~) ומסתיימים בשורה של טילדות שחייבת להיות ב
לפחות כל עוד שורת ההתחלה. כל דבר בין השורות הללו מטופל כקוד. לא
יש צורך בהזחה:

~~~~~~~
if (a > 3) {
moveShip(5 * כוח המשיכה, DOWN);
}
~~~~~~~

בדומה לקוביות קוד רגילות, יש להפריד בין קוביות קוד מגודרות מהטקסט שמסביב על ידי
שורות ריקות.

אם הקוד עצמו מכיל שורה של טילדות או סימנים לאחור, פשוט השתמשו בשורה ארוכה יותר של טילדים
או סימנים לאחור בהתחלה ובסוף:

~~~~~~~~~~~~~~~~
~~~~~~~~~~
קוד כולל tildes
~~~~~~~~~~
~~~~~~~~~~~~~~~~

סיומת: backtick_code_blocks
זהה ל-fenced_code_blocks, אבל משתמש ב-backticks (`) במקום tildes (~).

סיומת: תכונות_קוד_מגודרות
לחלופין, תוכל לצרף מאפיינים לבלוק קוד מגודר או לאחור באמצעות התחביר הזה:

~~~~ {#mycode .haskell .numberLines startFrom="100"}
qsort [] = []
qsort (x:xs) = qsort (מסנן (< x) xs) ++ [x] ++
qsort (מסנן (>= x) xs)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

כאן mycode הוא מזהה, haskell ו- numberLines הם מחלקות, ו-startFrom הוא an
תכונה עם ערך 100. פורמטים מסוימים של פלט יכולים להשתמש במידע זה כדי לבצע תחביר
הדגשה. נכון לעכשיו, פורמטי הפלט היחידים שמשתמשים במידע זה הם HTML ו
שרף גומי. אם הדגשה נתמכת עבור פורמט הפלט והשפה שלך, אז הקוד
הבלוק למעלה יופיע מודגש, עם שורות ממוספרות. (כדי לראות אילו שפות הן
נתמך, do pandoc --version.) אחרת, בלוק הקוד שלמעלה יופיע באופן הבא:



...



טופס קיצור יכול לשמש גם לציון שפת בלוק הקוד:

```הסקל
qsort [] = []
`` `

זה שווה ל:

``` {.haskell}
qsort [] = []
`` `

אם התוסף fenced_code_attributes מושבת, אבל הקלט מכיל מאפיינים מחלקים
עבור בלוק הקוד, תכונת המחלקה הראשונה תודפס לאחר גדר הפתיחה בתור א
מילה חשופה.

כדי למנוע כל הדגשה, השתמש בדגל --no-highlight. כדי להגדיר את סגנון ההדגשה,
השתמש ב--highlight-style. למידע נוסף על הדגשה, ראה הדגשת תחביר,
לְהַלָן.

קו אבני
סיומת: קו_בלוקים
בלוק קו הוא רצף של קווים המתחיל בפס אנכי (|) ואחריו רווח.
החלוקה לקווים תישמר בפלט, וכך גם כל החללים המובילים;
אחרת, השורות יעוצבו כ-Markdown. זה שימושי עבור פסוק ו
כתובות:

| חבילות הלימריק צוחקות בצורה אנטומית
| בחלל זה די חסכוני.
| אבל הטובים שראיתי
| כל כך נדיר שהם נקיים
| והנקיים לעתים רחוקות כל כך הם קומיים

| 200 Main St.
| ברקלי, קליפורניה 94718

ניתן לעטוף את השורות בצורה קשה במידת הצורך, אך קו ההמשך חייב להתחיל בא
חלל.

| הישר הנכבד הנכבד והצדיק ביותר שמואל ל.
שוטר, ג'וניור.
| 200 Main St.
| ברקלי, קליפורניה 94718

תחביר זה שאול מ-reStructuredText.

רשימות
כדור רשימות
רשימת תבליטים היא רשימה של פריטי רשימה עם תבליטים. פריט ברשימה עם תבליטים מתחיל בתבליט
(*, + או -). הנה דוגמה פשוטה:

* אחד
* שתיים
*שלושה

זה ייצור רשימה "קומפקטית". אם אתה רוצה רשימה "רופפת", שבה כל פריט
מעוצב כפסקה, שים רווחים בין הפריטים:

* אחד

* שתיים

*שלושה

הכדורים אינם צריכים להיות צמודים לשוליים השמאליים; הם עשויים להיות מחורצים אחד, שניים או
שלושה חללים. אחרי הכדור יש להופיע רווח לבן.

פריטי רשימה נראים בצורה הטובה ביותר אם השורות הבאות ישרות עם השורה הראשונה (אחרי התבליט):

*הנה הראשונה שלי
פריט רשימה.
* והשני שלי.

אבל Markdown מאפשר גם פורמט "עצלן":

*הנה הראשונה שלי
פריט רשימה.
* והשני שלי.

השמיים ארבעה חללים לשלוט
פריט רשימה עשוי להכיל פסקאות מרובות ותוכן אחר ברמת הבלוק. למרות זאת,
יש להקדים לפסקאות הבאות שורה ריקה ולהכניס ארבעה רווחים או טאב.
הרשימה תיראה טוב יותר אם הפסקה הראשונה מיושרת עם השאר:

* פסקה ראשונה.

נמשך.

* פסקה שניה. עם בלוק קוד, אותו יש להכניס הזחה
שמונה רווחים:

{ קוד }

פריטי רשימה עשויים לכלול רשימות אחרות. במקרה זה השורה הריקה הקודמת היא אופציונלית.
יש להכניס את הרשימה המקוננת לארבעה רווחים או לשונית אחת:

*פירות
+ תפוחים
- מקינטוש
- אדום טעים
+ אגסים
+ אפרסקים
* ירקות
+ ברוקולי
+ מנגולד

כפי שצוין לעיל, Markdown מאפשר לך לכתוב פריטי רשימה "בעצלתיים", במקום הזחה
קווי המשך. עם זאת, אם יש מספר פסקאות או בלוקים אחרים ברשימה
פריט, יש להכניס את השורה הראשונה של כל אחד.

+ רשימה עצלנית, עצלנית
פריט.

+ עוד אחד; זה נראה
רע אבל חוקי.

פסקה שנייה של שנייה
פריט רשימה.

הערה: למרות שכלל ארבעת הרווחים לפסקאות המשך מגיע מהפקיד
מדריך תחביר Markdown, יישום ההתייחסות, Markdown.pl, אינו עוקב אחריו. כך
pandoc ייתן תוצאות שונות מאלו של Markdown.pl כאשר המחברים הכניסו הזחה
פסקאות המשך של פחות מארבעה רווחים.

מדריך תחביר Markdown אינו מפורש אם כלל ארבעת הרווחים חל על את כל
תוכן ברמת הבלוק בפריט רשימה; הוא מזכיר רק פסקאות ובלוקי קוד. אבל זה
מרמז שהכלל חל על כל התוכן ברמת הבלוק (כולל רשימות מקוננות), וכן
פאנדוק מפרש את זה כך.

מסודר רשימות
רשימות מסודרות פועלות בדיוק כמו רשימות עם תבליטים, אלא שהפריטים מתחילים במונה
ולא כדורים.

ב-Markdown הסטנדרטי, המונים הם מספרים עשרוניים ואחריהם נקודה ורווח.
המספרים עצמם מתעלמים, כך שאין הבדל בין רשימה זו:

1. אחד
2. שניים
3. שלוש

וזה:

5. אחד
7. שניים
1. שלוש

סיומת: רשימות_מהודרות
בניגוד ל-Markdown הרגיל, Pandoc מאפשר לסמן פריטי רשימה מסודרים באותיות רישיות ו
אותיות קטנות וספרות רומיות, בנוסף לספרות ערביות. סמני רשימה עשויים להיות
מוקף בסוגריים או ואחריו סוגריים ימניים בודדים או נקודה. הם חייבים להיות
מופרדים מהטקסט שאחריו ברווח אחד לפחות, ואם סמן הרשימה הוא א
אות גדולה עם נקודה, בשני רווחים לפחות.

התוסף fancy_lists מאפשר גם '#' לשמש כסמן רשימה מסודרת במקום
ספרה:

#. אחד
#. שתיים

סיומת: startnum
Pandoc גם שם לב לסוג סמן הרשימה בו נעשה שימוש, ולמספר ההתחלתי,
ושני אלה נשמרים במידת האפשר בפורמט הפלט. לפיכך, הדברים הבאים
מניב רשימה עם מספרים ואחריהם סוגריים בודדים, החל מ-9, ו-a
רשימת משנה עם ספרות רומיות קטנות:

9) תשיעי
10) עשירית
11) האחד עשר
אני. subone
ii. תת שניים
iii. תת שלוש

Pandoc תתחיל רשימה חדשה בכל פעם שנעשה שימוש בסוג אחר של סמן רשימה. אז ה
הבא תיצור שלוש רשימות:

(2) שניים
(5) שלושה
1. ארבע
*חמש

אם רוצים לסמן ברירת מחדל של רשימה, השתמש ב-#.:

#. אחד
#. שתיים
#. שְׁלוֹשָׁה

הַגדָרָה רשימות
סיומת: הגדרות_רשימות
Pandoc תומך ברשימות הגדרות, תוך שימוש בתחביר של PHP Markdown Extra עם כמה
הרחבות.

קדנציה 1

: הגדרה 1

מונח 2 עם *סימון מוטבע*

: הגדרה 2

{ קוד מסוים, חלק מהגדרה 2 }

פסקה שלישית של הגדרה 2.

כל מונח חייב להתאים לשורה אחת, שלאחריה ניתן לחלופין שורה ריקה, וחייב
אחריו תופיע הגדרה אחת או יותר. הגדרה מתחילה במעי הגס או טילדה, אשר
ניתן להכניס רווח אחד או שניים.

למונח עשויות להיות הגדרות מרובות, וכל הגדרה עשויה להיות מורכבת מבלוק אחד או יותר
אלמנטים (פיסקה, בלוק קוד, רשימה וכו'), כל אחד הוזחה ארבעה רווחים או עצירת טאב אחת.
גוף ההגדרה (כולל השורה הראשונה, מלבד המעי הגס או הטילדה)
יש להכניס ארבעה רווחים. עם זאת, כמו ברשימות Markdown אחרות, אתה יכול "בעצלתיים"
השמט הזחה למעט בתחילת פסקה או רכיב בלוק אחר:

קדנציה 1

: הגדרה
עם המשך עצלן.

פסקה שנייה של ההגדרה.

אם תשאיר מקום לפני ההגדרה (כמו בדוגמה למעלה), הטקסט של ה-
ההגדרה תטופל כפסקה. בפורמטים מסוימים של פלט, המשמעות תהיה גדולה יותר
מרווח בין צמדי מונחים/הגדרה. לרשימת הגדרות קומפקטית יותר, השמיט את הרווח
לפני ההגדרה:

קדנציה 1
~ הגדרה 1

קדנציה 2
~ הגדרה 2א
~ הגדרה 2ב

שים לב שנדרש רווח בין פריטים ברשימת הגדרות. (גרסה שמתרופפת
דרישה זו, אך אינה מאפשרת עטיפה קשה "עצלה", ניתן להפעיל עם
compact_definition_lists: ראה הרחבות שאינן פנדוק, להלן.)

סָפוּר דוגמה רשימות
סיומת: דוגמאות_רשימות
ניתן להשתמש בסמן הרשימה המיוחד @ עבור דוגמאות ממוספרות ברצף. הרשימה הראשונה
פריט עם סמן @ יספרו '1', '2' הבא, וכן הלאה, לאורך כל הזמן
מסמך. הדוגמאות הממוספרות אינן חייבות להופיע ברשימה אחת; כל רשימה חדשה באמצעות @
יתפוס היכן שעצר לאחרונה. אז, למשל:

(@) הדוגמה הראשונה שלי תמוספר (1).
(@) הדוגמה השנייה שלי תהיה ממוספרת (2).

הסבר על דוגמאות.

(@) הדוגמה השלישית שלי תהיה ממוספרת (3).

ניתן לתייג דוגמאות ממוספרות ולהתייחס אליהן במקום אחר במסמך:

(@good) זו דוגמה טובה.

כפי שממחיש (@good)...

התווית יכולה להיות כל מחרוזת של תווים אלפאנומריים, קווים תחתונים או מקפים.

קוֹמפָּקטִי ו משוחרר רשימות
Pandoc מתנהג אחרת מ-Markdown.pl בכמה "מקרים קצה" הכוללים רשימות.
שקול את המקור הזה:

+ ראשית
+ שני:
- תשלום
- פי
- אויב

+ שלישי

Pandoc הופך את זה ל"רשימה קומפקטית" (עם לא תגים סביב "ראשון", "שני",
או "שלישי"), בעוד Markdown שם תגים סביב "שני" ו"שלישי" (אך לא "ראשון"),
בגלל החלל הריק סביב "שלישי". Pandoc פועל לפי כלל פשוט: אם הטקסט הוא
ואחריו שורה ריקה, הוא מטופל כפסקה. מאחר ש"שני" מלווה בא
רשימה, ולא שורה ריקה, היא אינה מטופלת כפסקה. העובדה שהרשימה היא
ואחריו שורה ריקה זה לא רלוונטי. (הערה: Pandoc עובד כך גם כאשר
צוין פורמט markdown_strict. התנהגות זו עולה בקנה אחד עם הפקיד
תיאור תחביר Markdown, למרות שהוא שונה מזה של Markdown.pl.)

סיום a רשימה
מה אם ברצונך לשים בלוק קוד מוזח אחרי רשימה?

- פריט ראשון
- פריט שני

{ בלוק הקוד שלי }

צרה! כאן pandoc (כמו יישומי Markdown אחרים) יתייחס ל-{ my code block } כאל
הפסקה השנייה של פריט שני, ולא כגוש קוד.

כדי "לחתוך" את הרשימה אחרי פריט שני, אתה יכול להכניס תוכן שאינו מוטבע, כמו
הערת HTML, שלא תייצר פלט גלוי בשום פורמט:

- פריט ראשון
- פריט שני



{ בלוק הקוד שלי }

אתה יכול להשתמש באותו טריק אם אתה רוצה שתי רשימות רצופות במקום רשימה אחת גדולה:

1. אחד
2. שניים
3. שלוש



1. uno
2. דוס
3. tres

מאוזן כללי
שורה המכילה שורה של שלושה או יותר תווים *, - או _ (מופרדים באופן אופציונלי על ידי
רווחים) מייצר כלל אופקי:

* * * *

---------------

לוחות
ניתן להשתמש בארבעה סוגי שולחנות. שלושת הסוגים הראשונים מניחים את השימוש בא
גופן ברוחב קבוע, כגון Courier. ניתן להשתמש בסוג הרביעי עם מרווח פרופורציונלי
גופנים, מכיוון שהוא אינו מצריך יישור עמודות.

סיומת: table_captions
ניתן לספק כיתוב עם כל 4 סוגי הטבלאות (כפי שמוצג ב-
דוגמאות למטה). כיתוב הוא פסקה שמתחילה במחרוזת Table: (או סתם :),
אשר יוסר. הוא עשוי להופיע לפני או אחרי הטבלה.

סיומת: פשוט_טבלאות
טבלאות פשוטות נראות כך:

ימין שמאל מרכז ברירת מחדל
------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1

טבלה: הדגמה של תחביר טבלה פשוט.

כל אחת מהכותרות והשורות בטבלה חייבות להתאים לשורה אחת. יישורי עמודות נקבעים על ידי
המיקום של טקסט הכותרת ביחס לקו המקווקו שמתחתיו:

· אם הקו המקווקו צמוד לטקסט הכותרת בצד ימין אך משתרע מעבר לו
בצד שמאל, העמודה מיושרת לימין.

· אם הקו המקווקו צמוד לטקסט הכותרת בצד שמאל אך משתרע מעבר לו
בצד ימין, העמודה מיושרת לשמאל.

· אם הקו המקווקו משתרע מעבר לטקסט הכותרת משני הצדדים, העמודה ממורכזת.

· אם הקו המקווקו צמוד לטקסט הכותרת משני הצדדים, יישור ברירת המחדל הוא
בשימוש (ברוב המקרים, זה יישאר).

הטבלה חייבת להסתיים בשורה ריקה, או בשורה של מקפים ואחריה שורה ריקה.

ניתן להשמיט את כותרות העמודות, בתנאי שנעשה שימוש בקו מקווקו לסיום הטבלה. ל
דוּגמָה:

------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1
------- ------ ---------- -------

כאשר כותרות מושמטות, יישור העמודות נקבע על בסיס השורה הראשונה
של גוף השולחן. אז, בטבלאות למעלה, העמודות יהיו ימין, שמאל, מרכז ו
מיושר לימין, בהתאמה.

סיומת: multiline_tables
טבלאות מרובות שורות מאפשרות לכותרות ולשורות טבלה להשתרע על פני שורות טקסט מרובות (אבל תאים
עמודות או שורות מרובות בטבלה אינם נתמכים). הנה דוגמא:

-------------------------------------------------- -----------
מרכז ברירת מחדל ימין שמאל
כותרת מיושרת מיושרת
----------- ------- --------------------------------------- --------
שורה ראשונה 12.0 דוגמה לשורה שבה
משתרע על מספר קווים.

שורה שנייה 5.0 הנה עוד אחת. הערה
השורה הריקה בין
שורות.
-------------------------------------------------- -----------

טבלה: הנה הכיתוב. גם זה עשוי להשתרע
שורות מרובות.

אלה פועלים כמו טבלאות פשוטות, אך עם ההבדלים הבאים:

· הם חייבים להתחיל בשורה של מקפים, לפני טקסט הכותרת (אלא אם כן הכותרות
הושמט).

· עליהם להסתיים בשורה של מקפים, ולאחר מכן בשורה ריקה.

· יש להפריד בין השורות בשורות ריקות.

בטבלאות מרובות שורות, מנתח הטבלאות שם לב לרוחב העמודות, ול-
סופרים מנסים לשחזר את הרוחבים היחסיים הללו בפלט. אז, אם אתה מוצא את זה אחד
העמודות צרות מדי בפלט, נסה להרחיב אותה במקור Markdown.

ניתן להשמיט כותרות בטבלאות מרובות שורות כמו גם בטבלאות פשוטות:

----------- ------- --------------------------------------- --------
שורה ראשונה 12.0 דוגמה לשורה שבה
משתרע על מספר קווים.

שורה שנייה 5.0 הנה עוד אחת. הערה
השורה הריקה בין
שורות.
----------- ------- --------------------------------------- --------

: הנה טבלה מרובת שורות ללא כותרות.

יתכן שלטבלה מרובת שורות תהיה רק ​​שורה אחת, אך יש לעקוב אחר השורה
על ידי שורה ריקה (ולאחר מכן שורת המקפים שמסיימת את הטבלה), או שהטבלה עשויה להיות
מתפרש כטבלה פשוטה.

סיומת: grid_tables
טבלאות רשת נראות כך:

: טבלת רשת לדוגמא.

+--------------+---------------+------- ---+
| פירות | מחיר | יתרונות |
+===============+===============+================ ===+
| בננות | $1.34 | - עטיפה מובנית |
| | | - צבע עז |
+--------------+---------------+------- ---+
| תפוזים | $2.10 | - מרפא צפדינה |
| | | - טעים |
+--------------+---------------+------- ---+

השורה של =s מפרידה בין הכותרת לגוף הטבלה, וניתן להשמיט אותה עבור a
טבלה ללא כותרות. התאים של טבלאות רשת עשויים להכיל רכיבי בלוק שרירותיים (מרובים
פסקאות, קוביות קוד, רשימות וכו'). יישורים אינם נתמכים, וגם תאים אינם נתמכים
משתרע על מספר עמודות או שורות. ניתן ליצור טבלאות רשת בקלות באמצעות מצב הטבלה של Emacs.

סיומת: pipe_tables
טבלאות צינור נראים כך:

| נכון | שמאל | ברירת מחדל | מרכז |
|------:|:------|--------|:------:|
| 12 | 12 | 12 | 12 |
| 123 | 123 | 123 | 123 |
| 1 | 1 | 1 | 1 |

: הדגמה של תחביר טבלת צינורות.

התחביר זהה לטבלאות PHP Markdown Extra. צינור ההתחלה והסיום
התווים הם אופציונליים, אך נדרשים צינורות בין כל העמודות. המעיים מעידים
יישור העמודות כפי שמוצג. לא ניתן להשמיט את הכותרת. כדי לדמות טבלה ללא כותרות,
כלול כותרת עם תאים ריקים.

מכיוון שהצינורות מציינים גבולות עמודים, אין צורך ליישר עמודות אנכית, כמו
הם בדוגמה לעיל. אז זהו שולחן צינורות חוקי לחלוטין (אם כי מכוער):

פירות| מחיר
-----|-----:
תפוח|2.05
אגס|1.37
כתום|3.09

התאים של טבלאות צינור אינם יכולים להכיל רכיבי בלוק כמו פסקאות ורשימות, ו
לא יכול להשתרע על מספר שורות. אם טבלת צינורות מכילה שורה שהתוכן הניתן להדפסה שלה הוא
רחב יותר מרוחב העמודה (ראה --עמודות), ואז תוכן התא יעטוף, עם ה-
רוחבי תאים יחסיים נקבעים לפי הרוחב של קווי ההפרדה.

הערה: pandoc מזהה גם טבלאות צינורות מהצורה הבאה, כפי שניתן להפיק על ידי
מצב ה-orgtbl של Emacs:

| אחד | שני |
|-----+-------|
| שלי | שולחן |
| הוא | נחמד |

ההבדל הוא שמשתמשים ב-+ במקום |. תכונות orgtbl אחרות אינן נתמכות.
בפרט, כדי לקבל יישור עמודות שאינו ברירת מחדל, תצטרך להוסיף נקודתיים כמתואר לעיל.

מידע נוסף אבני
סיומת: pandoc_title_block
אם הקובץ מתחיל בבלוק כותרת

% כותרת
% מחבר(ים) (מופרדים בפסיקים)
% תאריך

הוא ינותח כמידע ביבליוגרפי, לא כטקסט רגיל. (הוא ישמש, עבור
לדוגמה, בכותרת של פלט LaTeX או HTML עצמאי.) הבלוק עשוי להכיל רק א
כותרת, כותרת ומחבר, או כל שלושת המרכיבים. אם אתה רוצה לכלול מחבר אבל
ללא כותרת, או כותרת ותאריך אך ללא מחבר, אתה צריך שורה ריקה:

%
% מחבר

% הכותרת שלי
%
% 15 ביוני 2006

הכותרת עשויה לתפוס מספר שורות, אך שורות המשך חייבות להתחיל ברווח מוביל,
כך:

% הכותרת שלי
על מספר קווים

אם למסמך יש מספר מחברים, ניתן לשים את המחברים על שורות נפרדות עם מוביל
רווח, או מופרדים על ידי נקודה-פסיק, או שניהם. אז כל הדברים הבאים שווים:

% מחבר אחד
מחבר שני

% מחבר אחד; מחבר שני

% מחבר אחד;
מחבר שני

התאריך חייב להתאים על שורה אחת.

כל שלושת שדות המטא נתונים עשויים להכיל עיצוב מוטבע סטנדרטי (נטה, קישורים,
הערות שוליים וכו').

בלוקים של כותרת תמיד ינותחו, אבל הם ישפיעו על הפלט רק כאשר
נבחרה אפשרות עצמאית (-ים). בפלט HTML, כותרות יופיעו פעמיים: פעם אחת ב-
head document -- זו הכותרת שתופיע בראש החלון בדפדפן
-- ופעם אחת בתחילת גוף המסמך. הכותרת בראש המסמך יכולה
מצורפת קידומת אופציונלית (--title-prefix או -T option). הכותרת בגוף
מופיע כרכיב H1 עם המחלקה "כותרת", כך שניתן לדכא אותו או לאתחל איתו מחדש
CSS. אם קידומת כותרת צוינה עם -T ולא מופיעה בלוק כותרת במסמך,
קידומת הכותרת תשמש בעצמה ככותרת HTML.

כותב דף האיש מחלץ כותרת, מספר קטע של דף אדם וכותרות עליונות ותחתונות אחרות
מידע משורת הכותרת. ההנחה היא שהכותרת היא המילה הראשונה בכותרת
שורה, אשר עשויה להסתיים באופן אופציונלי במספר מקטע (חד ספרתי) בסוגריים.
(לא צריך להיות רווח בין הכותרת לסוגריים.) כל דבר אחרי זה הוא
ההנחה היא טקסט נוסף של כותרת תחתונה וכותרת עליונה. תו צינור בודד (|) צריך להיות
משמש להפרדת טקסט הכותרת התחתונה מטקסט הכותרת העליונה. לכן,

% PANDOC(1)

יניב דף אדם עם הכותרת PANDOC וסעיף 1.

% PANDOC(1) מדריכים למשתמש של Pandoc

יהיו גם "מדריך למשתמש של Pandoc" בכותרת התחתונה.

% PANDOC(1) מדריכים למשתמש של Pandoc | גרסה 4.0

יהיה גם "גרסה 4.0" בכותרת.

סיומת: yaml_metadata_block
בלוק מטא נתונים של YAML הוא אובייקט YAML חוקי, מופרד בשורה של שלושה מקפים (---)
בחלק העליון ושורה של שלושה מקפים (---) או שלוש נקודות (...) בתחתית. א ימל
חסימת מטא-נתונים עשויה להתרחש בכל מקום במסמך, אבל אם הוא לא בהתחלה, זה
יש להקדים שורה ריקה. (שימו לב שבגלל האופן שבו פנדוק משרשרת
קבצי קלט כאשר מסופקים כמה, אתה יכול גם לשמור את המטא נתונים ב-YAML נפרד
קובץ והעביר אותו ל-pandoc כארגומנט, יחד עם קבצי ה-Markdown שלך:

pandoc chap1.md chap2.md chap3.md metadata.yaml -s -o book.html

רק ודא שקובץ YAML מתחיל ב-- ומסתיים ב--- או ....)

מטא נתונים יילקחו מהשדות של אובייקט YAML ויתווספו לכל קיים
מטא נתונים של מסמך. מטא נתונים יכולים להכיל רשימות ואובייקטים (מקוננים באופן שרירותי), אבל כולם
סקלרים של מחרוזת יתפרשו כ-Markdown. שדות עם שמות המסתיימים בקו תחתון
יתעלם על ידי pandoc. (ייתכן שהם יקבלו תפקיד על ידי מעבדים חיצוניים.)

מסמך עשוי להכיל מספר בלוקים של מטא נתונים. שדות המטא נתונים ישולבו
דרך מוטה שמאל התאחדות: אם שני בלוקים של מטא נתונים מנסים להגדיר את אותו שדה, ה
הערך מהגוש הראשון יילקח.

כאשר Pandoc משמש עם -t markdown ליצירת מסמך Markdown, בלוק מטא נתונים של YAML
יופק רק אם נעשה שימוש באפשרות העצמאית -s/--. כל המטא נתונים יהיו
מופיעים בבלוק בודד בתחילת המסמך.

שימו לב שיש לפעול לפי כללי הבריחה של YAML. כך, למשל, אם כותרת מכילה א
נקודתיים, יש לצטט אותו. ניתן להשתמש בתו הצינור (|) כדי להתחיל בלוק מוזח
שיתפרש כפשוטו, ללא צורך בבריחה. טופס זה הכרחי
כאשר השדה מכיל שורות ריקות:

---
title: 'זו הכותרת: היא מכילה נקודתיים'
מְחַבֵּר:
- שם: מחבר אחד
שיוך: University of Somewhere
- שם: מחבר שני
שיוך: University of Nowhere
תגיות: [כלום, כלום]
תקציר: |
זה המופשט.

הוא מורכב משתי פסקאות.
...

משתני תבנית יוגדרו אוטומטית מהמטא נתונים. כך, למשל, ב
כתיבת HTML, תקציר המשתנה יוגדר ל-HTML המקבילה של Markdown in
השדה המופשט:

זה המופשט.
הוא מורכב משתי פסקאות.

הערה: משתנה המחבר בתבניות ברירת המחדל מצפה לרשימה פשוטה או מחרוזת. ל
השתמש במחברים המובנים בדוגמה, תצטרך תבנית מותאמת אישית. לדוגמה:

$for(author)$
$if(author.name)$
$author.name$$if(author.affiliation)$ ($author.affiliation$)$endif$
$אחר$
$author$
$endif$
$endfor$

קו אחורי בורח
סיומת: כל_סמלים_ניתנים להימלט
למעט בתוך בלוק קוד או קוד מוטבע, כל סימן פיסוק או תו רווח שלפניו
קו נטוי אחורי יטופל באופן מילולי, גם אם בדרך כלל זה יצביע על עיצוב.
כך, למשל, אם כותבים

*\*שלום\**

אחד יקבל

*שלום*

במקום

שלום

קל יותר לזכור את הכלל הזה מאשר הכלל הסטנדרטי של Markdown, המאפשר רק את
הדמויות הבאות ל-Slash-Escape:

\`*_{}[]()>#+-.!

(עם זאת, אם נעשה שימוש בפורמט markdown_strict, ייעשה שימוש בכלל Markdown הסטנדרטי).

רווח נמלט לאחור מנותח כרווח לא שביר. זה יופיע בפלט TeX
כ-~ וב-HTML ו-XML כ-\ או \.

קו נטוי אחורי עם בריחה (כלומר קו נטוי המתרחש בסוף שורה) מנותח
כשבר קו קשה. זה יופיע בפלט TeX בתור \\ וב-HTML as . זה
אלטרנטיבה נחמדה לדרך ה"בלתי נראית" של Markdown להצביע על מעברי קווים קשים באמצעות שניים
רווחים נגררים על קו.

בריחה לאחור לא עובדת בהקשרים מילוליים.

חכם פיסוק
הארכה
אם תצוין האפשרות --smart, Pandoc יפיק פלט נכון מבחינה טיפוגרפית,
המרת מרכאות ישרות למרכאות מתולתלות, --- למקפים, -- למקפים en... ל
אליפסות. רווחים לא שוברים מוכנסים לאחר קיצורים מסוימים, כגון "Mr."

הערה: אם תבנית ה-LaTeX שלך או כל קובץ כותרת כלול קורא לחבילת csquotes,
pandoc יזהה זאת באופן אוטומטי וישתמש ב-\enquote{...} לטקסט במירכאות.

בשורה עיצוב
דגש
ל להדגיש טקסט כלשהו, ​​הקף אותו ב-*s או _, כך:

הטקסט הזה _מודגש עם קווים תחתונים_, וזה
הוא *מודגש בכוכביות*.

כפול * או _ מייצר חזק דגש:

זהו **הדגשה חזקה** ו__עם קווים תחתונים__.

תו * או _ מוקף ברווחים, או עם נטוי אחורי, לא יפעיל הדגשה:

זה *לא מודגש *, ו\*גם זה לא\*.

סיומת: intraword_underscores
מכיוון ש-_ משמש לפעמים בתוך מילים ומזהים, Pandoc אינו מפרש _
מוקף בתווים אלפאנומריים כסמן הדגשה. אם אתה רוצה להדגיש
רק חלק ממילה, השתמש ב-*:

אפשרי*, לא אפשרי*.

פסילה
סיומת: פסילה
כדי למחוק קטע טקסט עם קו אופקי, התחל וסיים אותו ב-~~. לכן,
לדוגמה,

~~זה טקסט שנמחק.~~

כתבי על ו מנויים
סיומת: כתב עילית, מנוי
כתוביות עילית עשויות להיכתב על ידי הקיפת הטקסט בכתב עילי בתווים ^;
כתוביות מנוי עשויות להיכתב על ידי הקיפת הטקסט המנוי על ידי ~ תווים. לפיכך, עבור
דוגמא,

H~2~O הוא נוזל. 2^10^ הוא 1024.

אם הטקסט בעל הכתב העילי או המנוי מכיל רווחים, יש להשתמש ברווחים אלה
עם קווים אחוריים. (זה נועד למנוע כיתוב-על והרשמה בשוגג
השימוש הרגיל ב-~ ו-^.) לכן, אם אתה רוצה את האות P עם 'חתול' במנויים,
השתמש ב-P~a\ cat~, לא ב-P~a cat~.

מִלָה בְּמִלָה
כדי ליצור טווח קצר של טקסט מילה במילה, הכנס אותו בסימנים אחוריים:

מה ההבדל בין `>>=` ו`>>`?

אם הטקסט מילה במילה כולל סימן לאחור, השתמש בהתקתקות כפולות:

הנה תקתק מילולי `` ` ``.

(יתעלמו מהרווחים שאחרי סימני הפתיחה ולפני הסגירות האחוריות).

הכלל הכללי הוא שטווח מילולי מתחיל במחרוזת של סימנים רצופים
(אופציונלי ואחריו רווח) ומסתיים במחרוזת של אותו מספר סימנים לאחור
(אופציונלי לפניו רווח).

שימו לב ש-back-slash-escapes (ומבני Markdown אחרים) אינם פועלים מילה במילה
הקשרים:

זהו קו נטוי אחורי ואחריו כוכבית: `\*`.

סיומת: inline_code_attributes
ניתן לצרף תכונות לטקסט מילולי, בדיוק כמו בלוקי קוד מגודרים:

`<$>`{.haskell}

קָטָן כמוסות
כדי לכתוב אותיות קטנות, אתה יכול להשתמש בתג HTML span:

כובעים קטנים

(הנקודה-פסיק היא אופציונלית וייתכן שיש רווח אחרי הנקודתיים.) זה יעבוד בכל
פורמטי פלט התומכים באותיות קטנות.

מתמטיקה
סיומת: tex_math_dollars
כל דבר בין שני תווים $ יטופל כמתמטיקה של TeX. $ הפתיחה חייב להיות א
תו שאינו רווח מיד מימין לו, בעוד ש-$ הסוגר חייב להיות בעל רווח שאינו
תו מיד משמאלו, ואסור אחריו מיד ספרה. לכן,
$20,000 ו-$30,000 לא ינתחו כמתמטיקה. אם מסיבה כלשהי אתה צריך לצרף טקסט
תווים של $ מילוליים, הפוך אותם לאחור, והם לא יטופלו כמפרידים מתמטיים.

מתמטיקה TeX תודפס בכל פורמטי הפלט. אופן עיבודו תלוי בפלט
פורמט:

סימון, שרף גומי, אמאק אורג מצב, הֶקשֵׁר
זה יופיע מילה במילה בין $ תווים.

ReStructuredText
הוא יעובד באמצעות תפקיד טקסט מפורש :math:.

AsciiDoc
זה יוצג כ-latexmath:[...].

Texinfo
זה יעובד בתוך פקודת @math.

גרף איש
זה יוצג מילה במילה ללא $'s.

מדיה ויקי, דוקו ויקי
זה יוצג בפנים תגים.

טקסטיל
זה יוצג בתוך תגים.

RTF, OpenDocument, ODT
זה יעובד, במידת האפשר, באמצעות תווי Unicode, ובאופן אחר
מופיעים מילה במילה.

דוקוב
אם נעשה שימוש בדגל --mathml, הוא יעובד באמצעות MathML במשוואה פנימית
או תג אי-השוואה. אחרת הוא יעובד, אם אפשר, באמצעות unicode
תווים.

Docx זה יעובד באמצעות סימון מתמטי של OMML.

ספר בדיוני2
אם נעשה שימוש באפשרות --webtex, נוסחאות יעובדו כתמונות באמצעות Google Charts
או שירות אינטרנט תואם אחר, שהורד והוטמע בספר האלקטרוני. אחרת,
הם יופיעו מילה במילה.

HTML, סלידי, DZSlides, S5, EPUB
אופן עיבוד המתמטיקה ב-HTML יהיה תלוי באפשרויות שורת הפקודה שנבחרו:

1. ברירת המחדל היא להציג מתמטיקה של TeX ככל האפשר באמצעות תווי Unicode,
כמו עם פלט RTF, DocBook ו-OpenDocument. נוסחאות מונחות בתוך טווח
עם class="math", כך שהם עשויים להיות מעוצבים בצורה שונה מהסביבה
טקסט במידת הצורך.

2. אם נעשה שימוש באפשרות --latexmathml, מתמטיקה TeX תוצג בין $ או $$
תווים ולהכניס תגיות עם Class LaTeX. הסקריפט של LaTeXMathML יעשה זאת
לשמש לעיבודו כנוסחאות. (הטריק הזה לא עובד בכל הדפדפנים,
אבל זה עובד בפיירפוקס. בדפדפנים שאינם תומכים ב-LaTeXMathML, TeX Math
יופיע מילולית בין $ תווים.)

3. אם נעשה שימוש באפשרות --jsmat, מתמטיקה TeX תוכנס בתוך תגיות (עבור
מתמטיקה מוטבעת) או תגים (עבור מתמטיקה לתצוגה) עם מתמטיקה בכיתה. ה-jsMath
הסקריפט ישמש לעיבודו.

4. אם נעשה שימוש באפשרות --mimetex, הסקריפט mimeTeX CGI ייקרא אל
ליצור תמונות עבור כל נוסחת TeX. זה אמור לעבוד בכל הדפדפנים. ה
אפשרות --mimetex לוקחת כתובת URL אופציונלית כארגומנט. אם לא צוין כתובת אתר, זה
נניח שהסקריפט של mimeTeX CGI נמצא ב- /cgi-bin/mimetex.cgi.

5. אם נעשה שימוש באפשרות --gladtex, נוסחאות TeX יהיו מוקפות ב מתייג ב
פלט HTML. לאחר מכן, קובץ ה-htex המתקבל עשוי להיות מעובד על ידי gladTeX,
שייצרו קבצי תמונה לכל נוסחה וקובץ HTML עם קישורים ל
התמונות הללו. אז, ההליך הוא:

pandoc -s --gladtex myfile.txt -o myfile.htex
gladtex -d myfile-images myfile.htex
# מייצר את myfile.html ותמונות ב-myfile-images

6. אם נעשה שימוש באפשרות --webtex, נוסחאות TeX יומרו ל תגים
שמקשרים לסקריפט חיצוני הממיר נוסחאות לתמונות. הנוסחה
יקודד כתובת אתר ותשורשר לכתובת ה-URL שסופקה. אם אין כתובת URL
שצוין, ייעשה שימוש ב-Google Chart API
(http://chart.apis.google.com/chart?cht=tx&chl=).

7. אם נעשה שימוש באפשרות --mathjax, מתמטיקה TeX תוצג בין \(...\) (עבור
מתמטיקה מוטבעת) או \[...\] (עבור מתמטיקה לתצוגה) והכניסו תגיות עם class
מתמטיקה. הסקריפט של MathJax ישמש כדי לעבד אותו כנוסחאות.

חי HTML
סיומת: raw_html
Markdown מאפשר לך להוסיף HTML גולמי (או DocBook) בכל מקום במסמך (למעט
הקשרים מילוליים, שבהם <, > ו- & מתפרשים באופן מילולי). (טכנית זה לא
הרחבה, מכיוון ש-Markdown הסטנדרטי מאפשר זאת, אבל היא נעשתה הרחבה כך
ניתן להשבית אותו אם תרצה.)

ה-HTML הגולמי מועבר ללא שינוי ב-HTML, S5, Slidy, Slideous, DZSlides, EPUB,
Markdown, ופלט טקסטיל, ומדוכא בפורמטים אחרים.

סיומת: markdown_in_html_blocks
Standard Markdown מאפשר לך לכלול HTML "בלוקים": בלוקים של HTML בין מאוזנים
תגיות המופרדות מהטקסט שמסביב באמצעות שורות ריקות, ומתחילות ומסתיימות ב
השוליים השמאליים. בתוך בלוקים אלה, הכל מתפרש כ-HTML, לא כ-Markdown; כך
(לדוגמה), * אינו מסמל הדגשה.

Pandoc מתנהג כך כאשר נעשה שימוש בפורמט markdown_strict; אבל כברירת מחדל, pandoc
מפרש חומר בין תגיות בלוק HTML כ-Markdown. כך, למשל, Pandoc יהיה
לפנות



*אחד*
[קישור](http://google.com)



אל תוך



אחד
<a href="/http://google.com">קישור



ואילו Markdown.pl ישמור אותו כפי שהוא.

יש חריג אחד לכלל זה: טקסט בין and tags is not
מתפרש כמרקדאון.

יציאה זו מ-Markdown הסטנדרטי אמורה להקל על שילוב Markdown עם HTML
אלמנטים לחסום. לדוגמה, אפשר להקיף גוש של טקסט Markdown עם תגים
מבלי למנוע ממנו להתפרש כ-Markdown.

סיומת: native_divs
השתמש בלוקים מקוריים של Pandoc Div עבור תוכן בפנים תגים. לרוב זה צריך
תן את אותו פלט כמו markdown_in_html_blocks, אבל זה מקל על כתיבת pandoc
מסננים כדי לתפעל קבוצות של בלוקים.

סיומת: native_spans
השתמש בלוקים מקוריים של Pandoc Span עבור תוכן בתוך תגים. לרוב זה
צריך לתת את אותו פלט כמו raw_html, אבל זה מקל על כתיבת מסנני Pandoc
לתפעל קבוצות של שורות מוטבעות.

חי TeX
סיומת: raw_tex
בנוסף ל-HTML גולמי, Pandoc מאפשר לכלול LaTeX, TeX ו-ConTeXt בקובץ
מסמך. פקודות TeX מוטבעות יישמרו ויעברו ללא שינוי ל-LaTeX ו
כותבי ConTeXt. כך, למשל, אתה יכול להשתמש ב-LaTeX כדי לכלול ציטוטים של BibTeX:

תוצאה זו הוכחה ב-\cite{jones.1967}.

שים לב שבסביבות LaTeX, כמו

\begin{tabular}{|l|l|}\hline
גיל ותדירות \\ \hline
18--25 ו-15 \\
26--35 ו-33 \\
36--45 & 22 \\ \hline
\end{טבלאות}

החומר בין תגי ההתחלה והסיום יתפרש כ-LaTeX גולמי, לא כ
Markdown.

מתעלמים מ-Inline LaTeX בתבניות פלט שאינן Markdown, LaTeX ו-ConTeXt.

LaTeX פקודות מאקרו
סיומת: לטקס_מאקרו
עבור פורמטי פלט שאינם LaTeX, pandoc ינתח את LaTeX \newcommand ו-\renewcommand
הגדרות והחל את פקודות המאקרו המתקבלות על כל המתמטיקה של LaTeX. אז, למשל, ה
הבא יעבוד בכל פורמטי הפלט, לא רק LaTeX:

\newcommand{\tuple}[1]{\langle #1 \rangle}

$\tuple{a, b, c}$

בפלט LaTeX, הגדרת \newcommand פשוט תועבר ללא שינוי לפלט.

קישורים
Markdown מאפשר לציין קישורים בכמה דרכים.

מכני עם סלילה אוטומטית קישורים
אם תצרף כתובת אתר או כתובת אימייל בסוגריים מחודדים, הם יהפכו לקישור:

<http://google.com>
<[מוגן בדוא"ל]>

בשורה קישורים
קישור מוטבע מורכב מטקסט הקישור בסוגריים מרובעים, ואחריו כתובת האתר ב
סוגריים. (אופציונלי, ניתן לעקוב אחר כתובת האתר בכותרת קישור, במרכאות).

זהו [קישור מוטבע](/url), והנה [אחד עם
כותרת](http://fsf.org "לחץ כאן לשעה טובה!").

לא יכול להיות רווח בין החלק בסוגריים לחלק בסוגריים. הקישור
טקסט יכול להכיל עיצוב (כגון הדגשה), אבל הכותרת לא יכולה.

כתובות דוא"ל בקישורים מוטבעים אינן מזוהות אוטומטית, לכן יש להקדים אותן
mailto:

[כתוב לי!](mailto:[מוגן בדוא"ל])

התייחסות קישורים
An מפורש קישור הפניה כולל שני חלקים, הקישור עצמו והגדרת הקישור, אשר
עשוי להופיע במקום אחר במסמך (לפני או אחרי הקישור).

הקישור מורכב מטקסט קישור בסוגריים מרובעים, ואחריו תווית בסוגריים מרובעים.
(יכול להיות רווח בין השניים.) הגדרת הקישור מורכבת מהתווית בסוגריים,
אחריו נקודתיים ורווח, ואחריו כתובת האתר, ובאופן אופציונלי (אחרי רווח) א
כותרת הקישור בין מרכאות או בסוגריים. אסור לנתח את התווית בתור א
ציטוט (בהנחה שהרחבת הציטוטים מופעלת): הציטוטים מקבלים עדיפות על פני
תוויות קישור.

הנה כמה דוגמאות:

[התווית שלי 1]: /foo/bar.html "הכותרת שלי, אופציונלי"
[התווית שלי 2]: /foo
[התווית שלי 3]: http://fsf.org (קרן התוכנה החינמית)
[תווית 4 שלי]: /bar#special 'כותרת במרכאות בודדות'

אופציונלי, כתובת האתר עשויה להיות מוקפת בסוגריים זווית:

[התווית שלי 5]:http://foo.bar.baz>

הכותרת עשויה לעבור בשורה הבאה:

[התווית שלי 3]: http://fsf.org
"קרן התוכנה החינמית"

שים לב שתוויות קישור אינן תלויות רישיות. אז זה יעבוד:

הנה [הקישור שלי][FOO]

[Fo]: /bar/baz

ב משתמע קישור התייחסות, זוג הסוגריים השני ריק:

ראה [האתר שלי].

[האתר שלי]: http://foo.bar.baz

הערה: ב-Markdown.pl וברוב יישומי Markdown האחרים, עיין בהגדרות קישורים
לא יכול להתרחש בבניות מקוננות כגון פריטי רשימה או מרכאות בלוק. מרים פנדוק
הגבלה לכאורה שרירותית זו. אז הדבר הבא בסדר ב-pandoc, אם כי לא ב-
רוב המימושים האחרים:

> החסימה שלי [ציטוט].
>
> [ציטוט]: /foo

סיומת: shortcut_reference_links
ב קיצור קישור התייחסות, ניתן להשמיט לחלוטין את צמד הסוגריים השני:

ראה [האתר שלי].

[האתר שלי]: http://foo.bar.baz

פנימי קישורים
כדי לקשר למקטע אחר של אותו מסמך, השתמש בקובץ שנוצר באופן אוטומטי
מזהה (ראה מזהי כותרת). לדוגמה:

עיין ב[מבוא](#מבוא).

or

ראה [הקדמה].

[מבוא]: #מבוא

קישורים פנימיים נתמכים כעת עבור פורמטים של HTML (כולל הצגת שקופיות HTML ו
EPUB), LaTeX ו-ConTeXt.

תמונות
קישור שמיד לפניו א ! יטופל כאל תמונה. טקסט הקישור יהיה
משמש כטקסט חלופי של התמונה:


![סרט גלגל]

[סרט גלגל]: movie.gif

סיומת: דמויות_מרומזות
תמונה המתרחשת מעצמה בפסקה תוצג כדמות עם כיתוב.
(ב-LaTeX, תעשה שימוש בסביבת דמות; ב-HTML, התמונה תמוקם ב-div
עם דמות כיתה, יחד עם כיתוב ב-ap עם כיתוב כיתה.) התמונה של alt
טקסט ישמש בתור הכיתוב.


אם אתה רק רוצה תמונה מוטבעת רגילה, רק וודא שהיא לא הדבר היחיד בתמונה
פסקה. אחת הדרכים לעשות זאת היא להוסיף רווח לא שבור אחרי התמונה:

\

סיומת: link_attributes
ניתן להגדיר תכונות בקישורים ובתמונות:

מוטבע {#id .class width=30 height=20px}
וכן הפניה ![image][ref] עם תכונות.

[ref]: foo.jpg "כותרת אופציונלית" {#id .class key=val key2="val 2"}

(תחביר זה תואם ל-PHP Markdown Extra כאשר משתמשים רק ב-#id ו-.class.)

עבור HTML ו-EPUB, כל התכונות מלבד רוחב וגובה (אך כולל srcset וגדלים)
עוברים כמו שהם. הכותבים האחרים מתעלמים מתכונות שאינן נתמכות על ידי
פורמט הפלט שלהם.

תכונות הרוחב והגובה בתמונות מטופלות במיוחד. בשימוש ללא א
יחידה, ההנחה היא שהיחידה היא פיקסלים. עם זאת, כל אחד ממזהי היחידות הבאים
ניתן להשתמש: px, cm, mm, in, inch ו-%. אסור שיהיו רווחים בין המספר
והיחידה. לדוגמה:

{ width=50% }

· מידות מומרות לאינץ' לפלט בפורמטים מבוססי עמודים כמו LaTeX.
מידות מומרות לפיקסלים לפלט בפורמטים דמויי HTML. השתמש ב--dpi
אפשרות לציין את מספר הפיקסלים לאינץ'. ברירת המחדל היא 96dpi.

· יחידת % היא בדרך כלל יחסית לשטח פנוי כלשהו. למשל הדוגמה לעיל
ייתן ל (HTML),
\includegraphics[width=0.5\textwidth]{file.jpg} (LaTeX), או
\externalfigure[file.jpg][width=0.5\textwidth] (ConTeXt).

· לחלק מתבניות הפלט יש מושג של מחלקה (ConTeXt) או מזהה ייחודי (LaTeX
\caption), או שניהם (HTML).

· כאשר לא מצוינות תכונות רוחב או גובה, החזרה היא להסתכל על התמונה
הרזולוציה והמטא נתונים של dpi המוטמעים בקובץ התמונה.

הערות שוליים
סיומת: הערות שוליים
ה-Markdown של Pandoc מאפשר הערות שוליים, תוך שימוש בתחביר הבא:

הנה התייחסות להערת שוליים,[^1] ועוד אחת.[^longnote]

[^1]: הנה הערת השוליים.

[^longnote]: הנה אחד עם מספר בלוקים.

פסקאות עוקבות מוזחות כדי להראות שהן
שייכים להערת השוליים הקודמת.

{ some.code }

ניתן להכניס את הפסקה כולה, או רק את הראשונה
קַו. בדרך זו, הערות שוליים מרובות פסקאות פועלות כמו
פריטי רשימה מרובה פסקאות.

פסקה זו לא תהיה חלק מההערה, כי היא
אינו מוארך.

המזהים בהפניות להערות שוליים אינם יכולים להכיל רווחים, טאבים או שורות חדשות. אלה
המזהים משמשים רק כדי לתאם את ההפניה להערת השוליים עם ההערה עצמה; בתוך ה
פלט, הערות השוליים ימוספרו ברצף.

אין צורך להציב את הערות השוליים עצמן בסוף המסמך. הם עשויים להופיע
בכל מקום מלבד בתוך רכיבי בלוק אחרים (רשימות, מרכאות בלוק, טבלאות וכו').

סיומת: inline_notes
מותרות גם הערות שוליים מוטבעות (אם כי, בניגוד להערות רגילות, הן אינן יכולות להכיל
מספר פסקאות). התחביר הוא כדלקמן:

הנה הערה מוטבעת.^[קל יותר לכתוב הערות מוטבעות, שכן
אתה לא צריך לבחור מזהה ולזוז למטה כדי להקליד את
הערה.]

ניתן לערבב באופן חופשי הערות שוליים ורגילות.

ציטוטים
סיומת: ציטוטים
באמצעות מסנן חיצוני, pandoc-citeproc, pandoc יכול ליצור באופן אוטומטי ציטוטים ו
ביבליוגרפיה במספר סגנונות. שימוש בסיסי הוא

pandoc --פילטר pandoc-citeproc myinput.txt

על מנת להשתמש בתכונה זו, תצטרך לציין קובץ ביבליוגרפיה באמצעות ה
שדה מטא נתונים של ביבליוגרפיה במקטע מטא נתונים של YAML, או שורת הפקודה --bibliography
טַעֲנָה. אתה יכול לספק ארגומנטים מרובים --bibliography או להגדיר מטא נתונים של ביבליוגרפיה
שדה למערך YAML, אם ברצונך להשתמש במספר קובצי ביבליוגרפיה. הביבליוגרפיה עשויה
יש כל אחד מהפורמטים הבאים:

פורמט סיומת קובץ
──────────────────────────────
BibLaTeX .bib
BibTeX .bibtex
קופאק .קופאק

CSL JSON .json
CSL YAML .yaml
EndNote .enl
EndNote XML .xml
ISI .wos
MEDLINE .medline
MODS .mods
RIS .ris

שים לב שניתן להשתמש ב-.bib עם קבצי BibTeX ו-BibLaTeX כאחד; השתמש ב-.bibtex לכוח
BibTeX.

שימו לב ש-pandoc-citeproc --bib2json ו-pandoc-citeproc --bib2yaml יכולים לייצר ‎.json ו-
קבצי yaml מכל אחד מהפורמטים הנתמכים.

סימון בשדה: במסדי נתונים של BibTeX ו-BibLaTeX, pandoc-citeproc מנתח תת-קבוצה של
סימון LaTeX; בבסיסי נתונים של CSL YAML, pandoc Markdown; ובמסדי נתונים של CSL JSON, an
סימון דמוי HTML:


אותיות מוטות

...
סיכה

style="font-variant:small-caps;">... or ...
כותרות קטנות

...
מנוי

...
כתב עליון

class="nocase">...
למנוע ביטוי באותיות רישיות כאות כותרת

pandoc-citeproc -j ו-y ממירים בין הפורמטים CSL JSON ו-CSL YAML עד כמה
אפשרי.

כחלופה לציון קובץ ביבליוגרפיה באמצעות --bibliography או YAML
ביבליוגרפיה של שדה מטא נתונים, אתה יכול לכלול את נתוני הציטוטים ישירות בהפניות
שדה של המטא נתונים של YAML של המסמך. השדה צריך להכיל מערך של YAML מקודד
הפניות, למשל:

---
הפניות:
- סוג: כתב-עת-מאמר
מזהה: WatsonCrick1953
מְחַבֵּר:
- משפחה: ווטסון
נתון: JD
- משפחה: קריק
נתון: FHC
הפיקו:
חלקי תאריך:
- - 1953
- 4
- 25
כותרת: 'מבנה מולקולרי של חומצות גרעין: מבנה לדאוקסיריבוז
חומצות גרעין'
title-short: מבנה מולקולרי של חומצות גרעין
container-title: Nature
נפח: 171
גיליון: 4356
עמוד: 737-738
DOI: 10.1038/171737a0
כתובת האתר: http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
שפה: en-GB
...

(pandoc-citeproc --bib2yaml יכול להפיק אותם מקובץ ביבליוגרפיה באחד מה-
פורמטים נתמכים.)

ניתן לעצב ציטוטים והפניות באמצעות כל סגנון הנתמך על ידי סגנון הציטוט
שפה, רשומה במאגר סגנון Zotero. קבצים אלה מצוינים באמצעות ה-
אפשרות --csl או שדה המטא נתונים של csl. כברירת מחדל, pandoc-citeproc ישתמש בשיקגו
מדריך לפורמט תאריך מחבר סגנון. פרויקט CSL מספק מידע נוסף על
חיפוש ועריכה של סגנונות.

כדי להפוך את הציטוטים שלך להיפר-קישורים לערכי הביבליוגרפיה התואמים, הוסף
קישור-ציטוטים: נכון למטא נתונים של YAML שלך.

ציטוטים נכנסים בתוך סוגריים מרובעים ומופרדים על ידי נקודה-פסיק. כל ציטוט חייב
יש מפתח, המורכב מ-'@' + מזהה הציטוט ממסד הנתונים, ועשויים
לחלופין, יש קידומת, איתור וסיומת. מפתח הציטוט חייב להתחיל בא
אות, ספרה או _, ועשויים להכיל אלפאנומריות, _ ותווי פיסוק פנימיים
(:.#$%&-+?<>~/). הנה כמה דוגמאות:

בלה בלה [ראה @doe99, עמ' 33-35; גם @smith04, פרק. 1].

בלה בלה [@doe99, עמ' 33-35, 38-39 ו*פסים*].

בלה בלה [@smith04; @doe99].

pandoc-citeproc מזהה מונחי איתור בקבצי המקום של CSL. או מקוצר או
טפסים לא מקוצרים מתקבלים. באזור en-US, ניתן לכתוב מונחי איתור
צורות יחיד או רבים, כספר, bk./bks.; פרק, פרק/פרקים; טור,
col./cols.; דמות, איור/תורים; folio, fol./fols.; מספר, מס'/מס'; קו, l./ll.; הערה,
n./nn.; אופוס, אופ./אופ.; עמוד, עמ'/עמ'; פסקה, פסקה/פסקאות; חלק, נקודה/נקודות; סָעִיף,
שניות/שניות; sub verbo, sv/s.vv.; פסוק, נ/ה; נפח, כרך/כרכים; ¶/¶¶; §/§§. אם לא
נעשה שימוש במונח איתור, ההנחה היא "עמוד".

סימן מינוס (-) לפני ה-@ ידכא את אזכור המחבר בציטוט. זֶה
יכול להיות שימושי כאשר המחבר כבר מוזכר בטקסט:

סמית אומר בלה [-@smith04].

אתה יכול גם לכתוב ציטוט בטקסט, באופן הבא:

@smith04 אומר בלה.

@smith04 [עמ'. 33] אומר בלה.

אם הסגנון דורש רשימה של יצירות שצוטטו, היא תמוקם בסוף ה-
מסמך. בדרך כלל, תרצה לסיים את המסמך שלך בכותרת מתאימה:

פסקה אחרונה...

# הפניות

הביבליוגרפיה תוכנס אחרי כותרת זו. שימו לב שהכיתה הבלתי ממוספרת תעשה זאת
יתווסף לכותרת זו, כדי שהקטע לא ימוספר.

אם אתה רוצה לכלול פריטים בביבליוגרפיה מבלי לצטט אותם בגוף
טקסט, אתה יכול להגדיר שדה dummy nocite metadata ולשים שם את הציטוטים:

---
nocite: |
@item1, @item2
...

@item3

בדוגמה זו, המסמך יכיל ציטוט עבור פריט 3 בלבד, אך את הביבליוגרפיה
יכיל ערכים עבור פריט1, פריט2 ופריט3.

עבור פלט LaTeX או PDF, אתה יכול גם להשתמש ב- natbib או biblatex לעיבוד ביבליוגרפיה. ב
על מנת לעשות זאת, ציין קבצי ביבליוגרפיה כמתואר לעיל, והוסף --natbib or
--טיעון biblatex להפעלת פנדוק. זכור שקובצי ביבליוגרפיה חייבים להיות
בפורמט המתאים (או BibTeX או BibLaTeX).

למידע נוסף, עיין בדף האיש של pandoc-citeproc.

לא פנדוק סיומות
הרחבות תחביר Markdown הבאות אינן מופעלות כברירת מחדל ב-pandoc, אך עשויות להיות
מופעל על ידי הוספת +EXTENSION לשם הפורמט, כאשר EXTENSION הוא השם של
סיומת. כך, למשל, markdown+hard_line_breaks הוא Markdown עם קו קשה
נשבר.

סיומת: רשימות_ללא_קודם_שורה ריקה
אפשר לרשימה להופיע מיד אחרי פסקה, ללא רווח ריק מתערב.

סיומת: הפסקות_קו קשה
גורם לכל השורות החדשות בתוך פסקה להתפרש כמעברי שורות קשיחים במקום
רווחים.

סיומת: ignore_line_breaks
גורם להתעלמות משורות חדשות בתוך פסקה, במקום להתייחס אליהן כרווחים או
כמו שובר קו קשה. אפשרות זו מיועדת לשימוש עם שפות מזרח אסיה שבהן
לא משתמשים ברווחים בין מילים, אבל הטקסט מחולק לשורות לקריאה.

סיומת: הפסקות_קו_אסיאתיות
גורם להתעלמות משורות חדשות בתוך פסקה, במקום להתייחס אליהן כרווחים או
כמו הפסקות קו קשות, כשהן מתרחשות בין שתי דמויות רחבות מזרח אסיה. זה
בחירה טובה יותר מאשר ignore_line_breaks עבור טקסטים הכוללים שילוב של מזרח אסיה רחב
דמויות ודמויות אחרות.

סיומת: Emoji
מנתח אמוג'י טקסטואלי כמו :smile: כאמוטיקונים של Unicode.

סיומת: tex_math_single_slash
גורם לכל דבר בין \( ל-\) להתפרש כמתמטיקה מוטבעת של TeX, וכל דבר
בין \[ ו-\] להתפרש כתצוגה TeX מתמטיקה. הערה: חיסרון של זה
ההרחבה היא שהיא מונעת בריחה (ו-[.

סיומת: tex_math_double_backslash
גורם לכל דבר בין \\( ל-\\) להתפרש כמתמטיקה מוטבעת של TeX, וכל דבר
בין \\[ ו-\\] כדי להתפרש כתצוגה TeX מתמטיקה.

סיומת: markdown_attribute
כברירת מחדל, Pandoc מפרש חומר בתוך תגיות ברמת הבלוק כ-Markdown. זֶה
הרחבה משנה את ההתנהגות כך ש-Markdown מנותח רק בתוך תגיות ברמת הבלוק if
לתגים יש את התכונה markdown=1.

סיומת: mmd_title_block
מאפשר בלוק כותרת בסגנון MultiMarkdown בחלק העליון של המסמך, לדוגמה:

כותרת: הכותרת שלי
מחבר: ג'ון דו
תאריך: ספטמבר 1, 2008
הערה: זהו בלוק כותרת לדוגמה של mmd, עם
שדה המשתרע על מספר קווים.

עיין בתיעוד של MultiMarkdown לפרטים. אם pandoc_title_block או
yaml_metadata_block מופעל, הוא יקבל עדיפות על mmd_title_block.

סיומת: קיצורי מילים
מנתח מפתחות קיצור נוספים של PHP Markdown, כמו

*[HTML]: Hypertext Markup Language

שים לב שמודל מסמך Pandoc אינו תומך בקיצורים, אז אם הרחבה זו
מופעל, מפתחות קיצור פשוט מדלגים (בניגוד לניתוח כ
פסקאות).

סיומת: autolink_bare_uris
הופך את כל ה-URI המוחלט לקישורים, גם כאשר אינם מוקפים בסוגרים מחודדים <...>.

סיומת: ascii_identifiers
גורם למזהים המיוצרים על ידי auto_identifiers להיות ASCII טהור. מבטאים הם
הוסר מאותיות לטיניות מודגשות, ואותיות שאינן לטיניות מושמטות.

סיומת: mmd_link_attributes
מנתח מאפייני מפתח-ערך בסגנון ריבוי סימון בהפניות לקישור ותמונה. זֶה
אין לבלבל את ההרחבה עם התוסף link_attributes.

זוהי הפניה ![image][ref] עם תכונות ריבוי סימון.

[ref]: http://path.to/image "כותרת תמונה" רוחב=20 פיקסלים גובה=30 פיקסלים
id=myId class="myClass1 myClass2"

סיומת: mmd_header_identifiers
מנתח מזהי כותרות בסגנון ריבוי סימון (בסוגריים מרובעים, אחרי הכותרת אבל
לפני מספרים נגררים בכותרת ATX).

סיומת: רשימות_הגדרות_קומפקטיות
מפעיל את תחביר רשימת ההגדרות של pandoc 1.12.x ואילך. תחביר זה שונה
מזה שתואר לעיל תחת רשימות הגדרות בכמה היבטים:

· אין צורך בשורה ריקה בין פריטים עוקבים של רשימת ההגדרות.

· כדי לקבל רשימה "צמודה" או "קומפקטית", השמט רווח בין פריטים עוקבים; החלל
בין מונח להגדרתו אינו משפיע על דבר.

· אסור לעטוף פסקאות בעצלתיים: יש להכניס את כל ההגדרה לארבעה
רווחים.

Markdown גרסאות
בנוסף ל-Markdown המורחב של Pandoc, גרסאות ה-Markdown הבאות נתמכות:

markdown_phpextra (PHP Markdown תוֹסֶפֶת)
הערות שוליים, pipe_tables, raw_html, markdown_attribute, fenced_code_blocks,
definition_lists, intraword_underscores, header_attributes, link_attributes,
קיצורים, קישורי_הפניות_קיצור.

markdown_github (בטעם GitHub Markdown)
pipe_tables, raw_html, tex_math_single_backslash, fenced_code_blocks,
auto_identifiers, ascii_identifiers, backtick_code_blocks, autolink_bare_uris,
intraword_underscores, strikeout, hard_line_breaks, אימוג'י,
shortcut_reference_links.

markdown_mmd (MultiMarkdown)
pipe_tables raw_html, markdown_attribute, mmd_link_attributes, raw_tex,
tex_math_double_backslash, intraword_underscores, mmd_title_block, הערות שוליים,
definition_lists, all_symbols_escapable, implicit_header_references,
מזהים_אוטומטיים, מזהים_ראשי_ממדי, קישורי_הפניות_קיצור.

markdown_strict (Markdown.pl)
raw_html

רחבות עם פורמטים אַחֵר מֵאֲשֶׁר Markdown
ניתן להשתמש בחלק מההרחבות שנדונו לעיל עם פורמטים אחרים מלבד Markdown:

· ניתן להשתמש במזהים אוטומטיים עם קלט לטקס, rst, mediawiki וטקסטיל (ומשתמשים בו
כברירת מחדל).

· ניתן להשתמש ב-tex_math_dollars, tex_math_single_backslash ו-tex_math_double_backslash
עם קלט HTML. (זה שימושי לקריאת דפי אינטרנט המעוצבים באמצעות MathJax, עבור
דוגמא.)

ייצור שקופית מראה עִם PANDOC

אתה יכול להשתמש ב-pandoc כדי לייצר מצגת שקופיות HTML + javascript שניתן לצפות בה
דרך דפדפן אינטרנט. ישנן חמש דרכים לעשות זאת, באמצעות S5, DZSlides, Slidy, Slideous,
או reveal.js. אתה יכול גם להפיק הצגת שקופיות PDF באמצעות beamer LaTeX.

הנה מקור Markdown להצגת שקופיות פשוטה, habits.txt:

% הרגלים
% פלוני אלמוני
% 22 במרץ 2005

# בבוקר

## לקום

- כבה את האזעקה
- צא מהמיטה

## ארוחת בוקר

- לאכול ביצים
- לשתות קפה

# בערב

## ארוחת ערב

- לאכול ספגטי
- שתה יין

------------------


## הולך לישון

- היכנס למיטה
- לספור כבשים

כדי להפיק מצגת HTML/Javascript, פשוט הקלד

pandoc -t FORMAT -s habits.txt -o habits.html

כאשר FORMAT הוא s5, slidy, slideous, dzslides או revealjs.

עבור Slidy, Slideous, reveal.js ו-S5, הקובץ שהופק על ידי pandoc עם ה-
אפשרות עצמאית -s/--מטביעה קישור לקובצי javascript ו-CSS, אשר מניחים שהם
זמין בנתיב היחסי s5/default (עבור S5), slideous (עבור Slideous), reveal.js
(עבור reveal.js), או באתר Slidy בכתובת w3.org (עבור Slidy). (נתיבים אלה יכולים להיות
השתנה על ידי הגדרת המשתנים slidy-url, slideous-url, revealjs-url או s5-url; לִרְאוֹת
משתנים עבור שקופיות, למעלה.) עבור DZSlides, ה-Javascript וה-CSS (הקצרים יחסית) הם
כלול בקובץ כברירת מחדל.

עם כל הפורמטים של שקופיות HTML, ניתן להשתמש באפשרות --עצמה להפקת יחיד
קובץ המכיל את כל הנתונים הדרושים להצגת הצגת השקופיות, כולל מקושרים
סקריפטים, גיליונות סגנונות, תמונות וסרטונים.

כדי להפיק הצגת שקופיות PDF באמצעות beamer, הקלד

pandoc -t beamer habits.txt -o habits.pdf

שימו לב שניתן להמיר הצגת שקופיות של reveal.js ל-PDF על ידי הדפסתה לקובץ
מהדפדפן.

הַבנָיָה מה היא שקופית לְהַצִיג
כברירת מחדל, שקופית רָמָה היא רמת הכותרת הגבוהה ביותר בהיררכיה שאחריה
מיד לפי תוכן, ולא כותרת אחרת, איפשהו במסמך. בדוגמה
למעלה, כותרות רמה 1 תמיד עוקבות אחרי כותרות רמה 2, ואחריהן
תוכן, אז 2 היא רמת השקופית. ניתן לעקוף את ברירת המחדל הזו באמצעות --slide-level
אוֹפְּצִיָה.

המסמך מגולף לשקופיות לפי הכללים הבאים:

· כלל אופקי תמיד מתחיל שקופית חדשה.

· כותרת ברמת השקופית תמיד מתחילה שקופית חדשה.

· כותרות להלן רמת השקופיות בהיררכיה יוצרים כותרות בתוך שקופית.

· כותרות מֵעַל רמת השקופיות בהיררכיה יוצרים "שקופיות כותרת", שרק מכילות
את כותרת המדור ועזרה לחלק את הצגת השקופיות למקטעים.

· עמוד שער נבנה אוטומטית מגוש הכותרת של המסמך, אם קיים.
(במקרה של beamer, ניתן להשבית את זה על ידי הערת כמה שורות בברירת המחדל
תבנית.)

כללים אלה נועדו לתמוך בסגנונות רבים ושונים של הצגת שקופיות. אם לא
חשוב לבנות את השקופיות שלך למקטעים ותתי-קטעים, אתה יכול פשוט להשתמש ברמה 1
כותרות לכל שקופית. (במקרה כזה, רמה 1 תהיה רמת השקופית.) אבל אתה יכול
גם לבנות את הצגת השקופיות למקטעים, כמו בדוגמה למעלה.

הערה: בתצוגות שקופיות של reveal.js, אם רמת השקופיות היא 2, פריסה דו מימדית תהיה
מיוצר, עם בניית כותרות ברמה 1 אופקית ובניית כותרות ברמה 2
בֵּמְאוּנָך. לא מומלץ להשתמש בקינון עמוק יותר של רמות חתך עם
reveal.js.

מצטבר רשימות
כברירת מחדל, כותבים אלה מייצרים רשימות המציגות "בבת אחת". אם אתה רוצה את הרשימות שלך
כדי להציג בהדרגה (פריט אחד בכל פעם), השתמש באפשרות -i. אם אתה רוצה א
רשימה מסוימת כדי לצאת מברירת המחדל (כלומר, להציג בהדרגה ללא
אפשרות -i ובבת אחת עם אפשרות -i), שים אותה בציטוט בלוק:

> - לאכול ספגטי
> - לשתות יין

בדרך זו ניתן לערבב רשימות מצטברות ולא אינקרמנטליות במסמך אחד.

מכניס הפסקות
אתה יכול להוסיף "השהות" בשקופית על ידי הכללת פסקה המכילה שלוש נקודות,
מופרדים ברווחים:

# החלק עם הפסקה

תוכן לפני ההפסקה

. . .

תוכן לאחר ההפסקה

סִגנוּן מה היא שקופיות
אתה יכול לשנות את הסגנון של שקופיות HTML על ידי הכנסת קובצי CSS מותאמים אישית
$DATADIR/s5/default (עבור S5), $DATADIR/slidy (עבור Slidy), או $DATADIR/slideous (עבור
Slideous), כאשר $DATADIR הוא ספריית נתוני המשתמש (ראה --data-dir, למעלה). ה
ניתן למצוא מסמכים מקוריים בספריית נתוני המערכת של Pandoc (בדרך כלל
$CABALDIR/pandoc-VERSION/s5/default). Pandoc תחפש שם את כל הקבצים שלא
למצוא בספריית נתוני המשתמש.

עבור dzslides, ה-CSS כלול בקובץ ה-HTML עצמו, ועשוי להשתנות שם.

ניתן להגדיר את כל אפשרויות התצורה של reveal.js באמצעות משתנים. לדוגמה, ערכות נושא יכולות
לשמש על ידי הגדרת משתנה הנושא:

-V נושא=ירח

או שאתה יכול לציין גיליון סגנונות מותאם אישית באמצעות האפשרות --css.

כדי לעצב שקופיות beamer, אתה יכול לציין ערכת נושא, ערכת צבע, ערכת נושא של גופן, ערכת נושא פנימי ו
outertheme, באמצעות אפשרות -V:

pandoc -t beamer habits.txt -V theme:Warsaw -o habits.pdf

שים לב שתכונות כותרת יהפכו לתכונות שקופיות (ב-a אוֹ ) ב
פורמטים של שקופיות HTML, המאפשרים לך לעצב שקופיות בודדות. בbeamer, הכותרת היחידה
התכונה שמשפיעה על שקופיות היא מחלקה allowframebreaks, שקובע את
אפשרות allowframebreaks, הגורמת ליצירת שקופיות מרובות אם התוכן מתמלא יתר על המידה
המסגרת. זה מומלץ במיוחד עבור ביבליוגרפיות:

# הפניות {.allowframebreaks}

רַמקוֹל הערות
לגילוי.js יש תמיכה טובה בהערות דובר. אתה יכול להוסיף הערות למסמך Markdown שלך
כך:


זו ההערה שלי.

- זה יכול להכיל Markdown
- אוהב את הרשימה הזו



כדי להציג את חלון ההערות, הקש s תוך כדי הצגת המצגת. הערות עדיין לא
נתמך עבור פורמטים אחרים של שקופיות, אך ההערות לא יופיעו בשקופיות עצמן.

מסגרת תכונות in מכה
לפעמים יש צורך להוסיף את אפשרות LaTeX [שביר] למסגרת ב-beamer (עבור
לדוגמה, בעת שימוש בסביבה המוטבעת). ניתן לכפות זאת על ידי הוספת השביר
מחלקה לכותרת המציגה את השקף:

# שקף שביר {.שביר}

כל תכונות המסגרת האחרות המתוארות בסעיף 8.1 של המדריך למשתמש של Beamer עשויות
לשמש גם: allowdisplaybreaks, allowframebreaks, b, c, t, environment, label, plain,
לצמק.

יצירה EPUBS עִם PANDOC

EPUB מידע נוסף
ניתן לציין מטא נתונים של EPUB באמצעות האפשרות --epub-metadata, אך אם המקור
המסמך הוא Markdown, עדיף להשתמש בבלוק מטא נתונים של YAML. הנה דוגמא:

---
כותרת:
- סוג: ראשי
טקסט: הספר שלי
- סוג: כתובית
טקסט: חקירה של מטא נתונים
בורא:
- תפקיד: סופר
טקסט: ג'ון סמית'
- תפקיד: עורך
טקסט: שרה ג'ונס
מזהה:
- סכמה: DOI
טקסט: doi:10.234234.234/33
מוציא לאור: My Press
זכויות: © 2007 John Smith, CC BY-NC
...

השדות הבאים מוכרים:

מזהה
ערך מחרוזת או אובייקט עם טקסט וסכימה של שדות. ערכים חוקיים עבור
הסכימה היא ISBN-10, GTIN-13, UPC, ISMN-10, DOI, LCCN, GTIN-14, ISBN-13,
מספר פיקדון משפטי, URN, OCLC, ISMN-13, ISBN-A, JP, OLCC.

כותרת או ערך מחרוזת, או אובייקט עם שדות file-as ו-type, או רשימה של כאלה
חפצים. ערכים חוקיים לסוג הם ראשי, כותרת משנה, קצר, אוסף, מהדורה,
מורחב.

יוצר
או ערך מחרוזת, או אובייקט עם תפקיד שדות, file-as וטקסט, או רשימה
של חפצים כאלה. ערכים חוקיים לתפקיד הם מקורבי MARC, אך Pandoc ינסה
לתרגם את הגרסאות הניתנות לקריאה (כמו "מחבר" ​​ו"עורך") ל-
מקורבים מתאימים למארק.

תורם
אותו פורמט כמו היוצר.

נתונים ערך מחרוזת בפורמט YYYY-MM-DD. (רק השנה נחוצה.) פנדוק יעשה זאת
נסה להמיר תבניות תאריך נפוצות אחרות.

lang (אוֹ מוֹרֶשֶׁת: שפה)
ערך מחרוזת בפורמט BCP 47. Pandoc תהיה ברירת המחדל לשפה המקומית אם
שום דבר לא מצוין.

נושא
ערך מחרוזת או רשימה של ערכים כאלה.

תיאור
ערך מחרוזת.

סוג ערך מחרוזת.

פוּרמָט ערך מחרוזת.

יחס
ערך מחרוזת.

כיסוי
ערך מחרוזת.

זכויות ערך מחרוזת.

תמונת כריכה
ערך מחרוזת (נתיב לתמונת כריכה).

גיליון
ערך מחרוזת (נתיב לגיליון סגנונות CSS).

דף-התקדמות-כיוון
או ltr או rtl. מציין את תכונת ה-page-progression-direction עבור ה-
אלמנט עמוד השדרה.

צמוד מדיה
כברירת מחדל, Pandoc יוריד מדיה מקושרת (כולל אודיו ווידאו) ויכלול אותה
במיכל ה-EPUB, ומניב EPUB עצמאי לחלוטין. אם אתה רוצה לקשר
במקום זאת, השתמש במשאבי מדיה חיצוניים, השתמש ב-HTML גולמי במקור שלך והוסף ל-data-external="1".
התג עם התכונה src. לדוגמה:


<source src="/http://example.com/music/toccata.mp3"
data-external="1" type="audio/mpeg">

יוֹדֵעַ קְרוֹא וּכְתוֹב האסל תמיכה

אם תצרף +lhs (או +literate_haskell) לפורמט קלט או פלט מתאים
(markdown, markdown_strict, rst או latex עבור קלט או פלט; beamer, html או html5 עבור
פלט בלבד), Pandoc יתייחס למסמך כמקור Haskell יודע קרוא וכתוב. זה אומר ש

· בקלט Markdown, קטעי "מסלול ציפורים" ינותחו כקוד Haskell במקום
בלוק ציטוטים. טקסט בין \begin{code} ו-\end{code} יטופל גם הוא
קוד Haskell. עבור כותרות בסגנון ATX, התו '=' ישמש במקום '#'.

· בפלט Markdown, בלוקי קוד עם מחלקות haskell ו-literate יעובדו באמצעות
מסלולי ציפורים, וציטוטי בלוקים יוזחו רווח אחד, כך שהם לא יהיו
מטופל כקוד Haskell. בנוסף, הכותרות יעובדו בסגנון סטקסט (עם
קווי תחתון) ולא בסגנון ATX (עם תווים '#'). (זה בגלל ש-ghc מתייחס
תווים '#' בעמודה 1 ככניסה למספרי שורות.)

· בהזנת טקסט מחודשת, קטעי "מסלול ציפורים" ינותחו כקוד Haskell.

· בפלט טקסט מחודש, בלוקי קוד עם class haskell יעובדו באמצעות bird
מסלולים.

· בקלט LaTeX, טקסט בסביבות קוד ינותח כקוד Haskell.

· בפלט LaTeX, בלוקי קוד עם class haskell יעובדו בתוך הקוד
סביבות.

· בפלט HTML, בלוקי קוד עם class haskell יעובדו עם class
קרוא וכתוב מסלולי ציפורים.

דוגמאות:

pandoc -f markdown+lhs -t html

קורא מקור Haskell יודע קרוא וכתוב בפורמט עם מוסכמות Markdown וכותב HTML רגיל
(ללא עקבות ציפורים).

pandoc -f markdown+lhs -t html+lhs

כותב HTML עם קוד Haskell במסלולי ציפורים, כך שניתן להעתיק אותו ולהדביק אותו בתור
מקור האסקל יודע קרוא וכתוב.

תחביר הדגשה

Pandoc ידגיש אוטומטית תחביר בלוקי קוד מגודרים המסומנים ב-a
שם השפה. ספריית Haskell highlighting-cat משמשת להדגשה, אשר
עובד בפלט HTML, Docx ו-LaTeX/PDF. ניתן לבחור את ערכת הצבעים באמצעות
- אפשרות בסגנון הדגשה. ערכת הצבעים המוגדרת כברירת מחדל היא פיגמנטים, המחקה את
ערכת הצבעים המוגדרת כברירת מחדל בשימוש על ידי פיגמנטים של ספריית Python, אך פיגמנטים לא
משמש לביצוע ההדגשה.

כדי לראות רשימה של שמות שפות ש-pandoc יזהה, הקלד pandoc --version.

כדי להשבית את ההדגשה, השתמש באפשרות --no-highlight.

המותאם אישית כותבים

ניתן להרחיב את Pandoc עם כותבים מותאמים אישית שנכתבו ב-lua. (פנדוק כולל לואה
מתורגמן, אז אין צורך להתקין את lua בנפרד.)

כדי להשתמש בסופר מותאם אישית, פשוט ציין את הנתיב לסקריפט lua במקום הפלט
פוּרמָט. לדוגמה:

pandoc -t data/sample.lua

יצירת כותב מותאם אישית דורשת כתיבת פונקציית lua עבור כל אלמנט אפשרי ב-a
מסמך פנדוק. כדי לקבל דוגמה מתועדת שתוכל לשנות בהתאם
צריך, לעשות

pandoc --print-default-data-file sample.lua

מחברים

© 2006-2015 ג'ון מקפרלן ([מוגן בדוא"ל]). שוחרר תחת GPL, גרסה 2 או
גדול יותר. תוכנה זו אינה נושאת אחריות מכל סוג שהוא. (ראה זכויות יוצרים למלא
הודעות זכויות יוצרים ואחריות.)

התורמים כוללים את אהרון וולן, אלברט קרווינקל, אלכסנדר קונדרצקי, אלכסנדר
סולפריאן, אלכסנדר החמישי ורשילוב, אלפרד וכסלברגר, אנדראס לואו, אנדרו דאנינג,
אנטואן לאטר, ארטה מיזוקי, ארלו אוקיף, ארטיום קזאק, בן גמארי, בני
צ'רניאבסקי-פסקין, ביורן באקווטר, בראדלי קון, ברנט יורג'י, בריאן אוסאליבן, ב.
סקוט מישל, קיילב מקדניאל, קלווין בק, כריסטופר אקלמן, כריסטופר סוויקי,
קלייר מקרי, קלינט אדמס, קונל אליוט, קרייג ס. בוסמה, דניאל ברגי, דניאל טי.
סטאל, דיוויד לזר, דיוויד רותליסברגר, דניס לקסלדה, דאגלס קלברט, דאגלס פ.
קלברט, אריק קאו, אריק זיידל, פלוריאן איטל, פרנסואה גאנאז, פרייריק בראל, פיודור
שרמטייב, גאבור פאלי, גאווין ביטי, גרג מסלוב, גרגורי בטאיל, גרג רונדלט,
gwern, Gwern Branwen, Hans-Peter Deifel, Henry de Valence, Ilya V. Portnov, infinity0x,
חיימה מרקינס פרנדיז, ג'יימס אספנס, ג'יימי פ. אולסון, יאן לארס, ג'ייסון רונלו, ג'ף
ארנולד, ג'ף רנינגן, ג'נס פטרסן, ג'רמי בוביו, ג'סי רוזנטל, ג'יי לואיס מיור, ג'ו
הילנברנד, ג'ון מקפרלן, ג'ונאס סמדגור, ג'ונתן דאהרטי, יוזף סווננינגסון,
חוסה לואיס דוראן, ג'וליאן כרתל, ג'סטין בוגנר, קלסי הייטאוור, קונסטנטין זודוב,
לארס-דומיניק בראון, לוק פלאנט, מארק ספיאנייץ', מארק רייט, מסאיושי טקהאשי, מאטי'
קולר, מתיאס שנר, מתיו פיקרינג, מתיאס CM טרופה, מאורו בייג, מקס
בולינגברוק, מקס רידהל אנדרסן, מרין ורסטראטן, מייקל סנוימן, מייקל תומפסון,
MinRK, נתן גאס, ניל מייו, ניק בארט, ניקולס קייזר, ניקולאי יאקימוב, nkalvi, פאולו
טנימוטו, פול ריבייר, פיטר וואנג, פיליפ אומברדאן, פיליפ אלדיי, פונת' צ'אגנטי,
qerub, Ralf Stephan, Recai Oktaş, rodja.trappe, RyanGlScott, Scott Morrison, Sergei
טרופימוביץ', סרגיי אסטנין, שאהבז יוספי, שון אטפילד, shreevatsa.public, סיימון
הנגל, סומיט סהרוואט, טקהאשים, תסטון, טים לין, טימותי האמפריז, טוד סיפלט,
טום ליס, אולי קוהלר, ואצלב זמאן, ויקטור קרונוול, וינסנט, ויקיוויד וקסבייר אוליב.

ניתן להוריד את קוד המקור של Pandoc ואת כל התיעודhttp://pandoc.org>.

השתמש ב-pandoc באינטרנט באמצעות שירותי onworks.net