[TOC] <br/><br/><br/> # <b style="color:#4F4F4F;">簡介說明</b> 原文鏈接： - [pythondoc](http://www.pythondoc.com/sphinx/rest.html) - [sphinx-doc](https://zh-sphinx-doc.readthedocs.io/en/latest/rest.html) ``` 版本：reStructuredText 作用：輕量級標記語言的一種 ``` <br/> # <b style="color:#4F4F4F;">排版元素</b> <br/> # <span style="color:#619BE4">=========</span> ***** 一級標題 <br/> # <span style="color:#619BE4">------------------</span> ***** 二級標題 <br/> # <span style="color:#619BE4">^^^^^^^^^^^^^^^^^^^^</span> ***** 三級標題 <br/> # <span style="color:#619BE4">\*text\*</span> ***** 強調 (斜體) <br/> # <span style="color:#619BE4">\*\*text\*\*</span> ***** 重點強調 (加粗) <br/> # <span style="color:#619BE4">\`\`code\`\`</span> ***** 代碼樣式 <br/> # <span style="color:#619BE4">\`描述<鏈接地址>\`_</span> ***** 超鏈接 <br/> ### 示例內容 <span style="color:red;">1. 舉例說明</span> ``` `baidu <http://www.baidu.com>`_ ``` <br/> # <span style="color:#619BE4">* </span> ***** 無序列表 <br/> # <span style="color:#619BE4">#. </span> ***** 有序列表 <br/> # <span style="color:#619BE4">1. </span> ***** 有序列表 <br/> # <span style="color:#619BE4">\| </span> ***** 分割句子 <br/> # <span style="color:#619BE4"> :ref:\`錨點名稱\`</span> ***** 定義可跳轉的錨點 <br/> ### 示例內容 <span style="color:red;">1. 舉例說明</span> ``` .. _my-reference-label: :ref:`my-reference-label` ``` <br/> # <span style="color:#619BE4"> :emphasis:\`字體\`</span> ***** 斜體字 <br/> # <span style="color:#619BE4"> :strong:\`字體\`</span> ***** 粗體字 <br/> # <span style="color:#619BE4"> :literal:\`字體\`</span> ***** 斜體字 <br/> # <span style="color:#619BE4"> :subscript:\`字體\`</span> ***** 上標 <br/> # <span style="color:#619BE4"> :superscript:\`字體\`</span> ***** 下標 <br/> # <span style="color:#619BE4"> :title-reference:\`字體\`</span> ***** 書刊引用 <br/> # <span style="color:#619BE4">|name|</span> ***** 定義可替換塊 <br/> ### 示例內容 <span style="color:red">1. 舉例說明</span> ``` .. |name| replace:: replacement *text* .. |caution| image:: warning.png :alt: Warning! ``` <br/> # <span style="color:#619BE4">..image::</span> ***** 定義圖片 <br/> ### 示例內容 <span style="color:red">1. 舉例說明</span> ``` |引用名稱| .. |引用名稱| image:: https://travis-ci.org/SystemLight/madtornado.svg?branch=master :target: https://travis-ci.org/SystemLight/madtornado ``` <br/> ### 參數說明 <b style="color:#808080;">target</b> * 類型：字符串 * 默認值：無 * 描述：跳轉鏈接 * 可選值：[ ] <br/> # <span style="color:#619BE4">..figure::</span> ***** 引用圖片渲染 <br/> ### 示例內容 <span style="color:red;">1. 舉例說明</span> ``` .. _my-figure: .. figure:: https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1598783977266&di=b73018ff6f9fb35b250711dcb7a6b912&imgtype=0&src=http%3A%2F%2Ft8.baidu.com%2Fit%2Fu%3D2247852322%2C986532796%26fm%3D79%26app%3D86%26f%3DJPEG%3Fw%3D1280%26h%3D853 Figure caption :ref:`my-figure` ``` <br/> # <span style="color:#619BE4">..function::</span> ***** 調用python函數 <br/> ### 參數說明 <b style="color:#808080;">module</b> * 類型：字符串 * 默認值：無 * 描述：指定模塊路徑 * 可選值：[ ] <br/> ### 示例內容 <span style="color:red">1. 舉例說明</span> ``` .. function:: foo(x) foo(y, z) :module: some.module.name 返回用戶輸入的一行文本. ``` <br/> # <span style="color:#619BE4">.. rubric::</span> ***** 聲明尾注 <br/> ### 示例內容 <span style="color:red">1. 舉例說明</span> ``` Lorem ipsum [#f1]_ dolor sit amet ... [#f2]_ .. rubric:: Footnotes .. [#f1] 第一條尾注的文本. .. [#f2] 第二條尾注的文本. ``` <br/> # <span style="color:#619BE4">.. [Ref]</span> ***** 定義參考 <br/> ### 示例內容 <span style="color:red">1. 舉例說明</span> ``` Lorem ipsum [Ref]_ dolor sit amet. .. [Ref] 參考文獻, 書,URL 等. ``` <br/>