Markdown 參考指南

Fuchsia.dev 支援本指南中說明的 Markdown 元素。

段落式引文

Markdown 會使用大於字元 (>) 將文字轉譯為區塊引文 (即引文文字)。

Markdown

This is a Markdown paragraph.

> This is a blockquote with two paragraphs. The first line of a blockquote
> paragraph has to have a greater-than character (`>`), but for readability
> in the source file, add a greater-than character to every subsequent line
> of the paragraph like this example. Though this isn't a requirement as
> shown in the second blockquote paragraph below.
>
> This is a second blockquote paragraph that only has a greater-than
character (`>`) for the first line. Donec sit amet nisl. Aliquam semper
ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus
adipiscing. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec,
fringilla in, laoreet vitae, risus.

已算繪

這是 Markdown 段落。

這是包含兩個段落的引用文字。內嵌文字段落的第一行必須包含大於號字元 (>);但為了確保來源檔案中的可讀性,請在內嵌文字段落的後續每行加入大於號字元,如本範例所示。不過,這並非必要條件,如下方第二個引文區塊段落所示。

這是第二個內嵌引言段落,第一行只有一個大於符號 (>)。Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

程式碼區塊

程式碼區塊可用於提供程式輔助範例或標記原始碼。程式碼區塊內的內容不會像一般 Markdown 段落一樣進行剖析,而是會按照寫入的方式顯示。

您可以使用程式碼區塊指定要用來顯示程式碼以供醒目顯示的程式語言

在三個倒引號 (```) 前後都必須有空白行。倒引號不會顯示在最終輸出內容中。不過,程式碼區塊中的空白行會顯示在最終輸出內容中。

Markdown

Example 1: Uses Java syntax highlighting

```java
public class Hello {

  public static void main(String arg[]) {

    System.out.println("Hello.");
  }
}
```

Example 2: Prevents syntax highlighting

```none {:.devsite-disable-click-to-copy}
Some pseudo-code doesn't need syntax highlighting.
```

Example 3: Includes a replacement variable

```none {:.devsite-disable-click-to-copy}
Hello, my name is {{ '<var>' }}your-name{{ '</var>' }}.
```

產生的 HTML

<p>Example 1: Uses Java syntax highlighting</p>
<pre class="prettyprint lang-java"><code>public class Hello {<br/>public
static void main(String arg[]) {<br/>System.out.println("Hello.");<br/>}
<br/>}<br/></code></pre>
<p>Example 2: Prevents syntax highlighting</p>
<pre class="click-to-copy"><code><br/><p>Some pseudo-code doesn't need
syntax highlighting.</p><br/>
</code></pre>
<p>Example 3: Includes a replacement variable</p>
<pre class="no-prettyprint"><code><br/><p>Hello, my name is <var>your-name</var>.
</p><br/></code></pre>

已算繪

範例 1:使用 Java 語法醒目顯示

public class Hello {

  public static void main(String arg[]) {

    System.out.println("Hello.");
  }
}

範例 2:避免語法醒目顯示

Some pseudo-code doesn't need syntax highlighting.

示例 3:包含替換變數

Hello, my name is your-name.

在程式碼區塊中使用可替換的變數

如要在程式碼區塊中使用 <var> 標記,請使用 Jinja 運算式方括號,如下所示:

{{ '<var>' }}PORT{{ '</var>' }}

上方範例會轉譯以下內容:

PORT

留言

Fuchsia.dev 支援 Markdown 和 HTML 中的單行和多行註解。留言不會顯示在已發布的頁面上。如果文件包含 includecodeMathJax,這些註解就很實用,可提醒編輯者。

單行註解

{# This is a single line comment #}

多行註解

如要在 fuchsia.dev 上使用多行註解,請按照下列步驟操作:

使用 {# ... #} 包住每行內容。這適用於 HTML 和 Markdown:

{# I wonder how drivers are doing? #}
{# I hear they are awesome! #}

自訂屬性

Fuchsia.dev 可讓您在 Markdown 檔案中設定自訂 HTML 屬性 (例如 classidattribute='value')。

支援的 Markdown 元素

下列元素支援自訂屬性:

  • 程式碼區間
  • 程式碼區塊
  • 標題
  • 連結
  • 清單
  • 段落
  • 表格和多行表格

格式

語法 說明
{} 自訂屬性的開始和結束時間。
: 這是 fuchsia.dev 中 Markdown 自訂屬性所需的值。
. 在句點 (.) 後面的字詞會設定元素的 class
# 雜湊符號 (#) 後面的字詞會設定元素的 id
attribute='value' 為元素設定屬性名稱和值組合;使用空格分隔組合。

Markdown

This is a Markdown paragraph.
{:.customClass #custom_id attribute='value'}

產生的 HTML

<p class="customClass" id="custom_id" attribute="value">This is a Markdown paragraph.</p>

定義清單

如要在 Markdown 中建立定義清單,請在單行中列出該詞彙,然後在定義下方的新行中,在每個定義前加上半形冒號 (:)。

Markdown

Apple
: A fruit
: A tech company

Orange
: A citrus fruit

    A definition can also contain other block or inline elements. This is a
    paragraph within the same definition as "A citrus fruit". Elements
    within must be indented four spaces to be recognized as part of the
    preceding definition.

: A color

產生的 HTML

<dl>
  <dt>Apple</dt>
  <dd>A fruit</dd>
  <dd>A tech company</dd>

  <dt>Orange</dt>
  <dd>
    <p>A citrus fruit</p>
    <p>
      A definition can also contain other block or inline elements. This is
      a paragraph within the same definition as "A citrus fruit". Elements
      within must be indented four spaces to be recognized as part of the
      preceding definition.
    </p>
  </dd>
  <dd>
    <p>A color</p>
  </dd>
</dl>

已算繪

Apple (蘋果)
水果
科技公司
Orange

柑橘類水果

定義也可以包含其他區塊或內嵌元素。這是「柑橘類水果」這個定義中的段落。內部的元素必須縮排四個空格,才能被視為上述定義的一部分。

顏色

強調和強烈

Markdown 會使用星號 (*) 和底線 (_) 進行強調和加強格式設定。

強調效果

以一個星號 (*) 或底線 (_) 括住的文字會為特定文字提供斜體樣式。

Markdown

*single asterisks*

_single underscores_

supercali*fragilistic*expialidocious

supercali_fragilistic_expialidocious                 // won't format

產生的 HTML

<em>single asterisks</em>

<em>single underscores</em>

supercali<em>fragilistic</em>expialidocious

supercali_fragilistic_expialidocious

已算繪

單星號

單下線

supercalifragilisticexpialidocious

supercali_fragilistic_expialidocious

以兩個星號 (**) 或底線 (__) 括住的文字,可為特定文字設定粗體樣式。

Markdown

**double asterisks**

__double underscores__

supercali**fragilistic**expialidocious

supercali__fragilistic__expialidocious

產生的 HTML

<strong>double asterisks</strong>

<strong>double underscores</strong>

supercali<strong>fragilistic</strong>expialidocious

supercali<strong>fragilistic</strong>expialidocious

已算繪

雙星號

雙下劃線

supercalifragilisticexpialidocious

supercalifragilisticexpialidocious

逸出

某些字元是 Markdown 中的保留語法。如要使用特殊字元,請使用反斜線逸出字元 (\) 來顯示下列文字字元:

\   backslash
`   backtick
*   asterisk
_   underscore
{}  curly braces
[]  square brackets
()  parentheses
#   hash mark
+   plus sign
-   minus sign (hyphen)
.   dot
!   exclamation mark

註腳

附註是實用的工具,可用於加入額外或補充內容,而不會中斷網頁的流程。語法類似參照連結:

In the main text, include a label[^1] that starts with a caret.

[^1]: The footnote content goes here.

[^2]: Longer footnote content can be span multiple lines
    by indenting the continuation 4 spaces.

只要附註標籤開頭為方括號 ^,即可使用任意字串。

標題

Markdown 支援 atx 樣式標題,會在行開頭使用一到六個雜湊字元 (#),對應至標題層級 1 到 6。

Markdown

# This is an H1

## This is an H2

###### This is an H6

已算繪

這是 H1

這是 H2

這是 H6

標頭 ID

Fuchsia.dev 支援每個標頭的自訂 HTML id 屬性。如要覆寫預設的 id,請在 Markdown 標題結尾處新增自訂屬性 {#user_defined_name}

Markdown

# Working with contacts {#working-with-contacts}
## Contact Entry
### Contacts are working

產生的 HTML

<h1 id="working-with-contacts">Working with contacts</h1>
<h2 id="contact-entry">Contact Entry</h2>
<h3 id="contacts-are-working">Contacts are working</h3>

目錄

對於每個第二和第三層標題,fuchsia.dev 會自動為網頁產生目錄 (TOC)。如要隱藏目錄中的標題,請在標題結尾處新增自訂屬性 {:.hide-from-toc}

Markdown

## Hidden in TOC {:.hide-from-toc}             // try to find it!

已算繪

隱藏在 TOC 中

水平規則

Markdown 支援水平規則代碼 (<hr>),只要在一行中加入三個或更多的連字號、星號或底線即可。

下列每一行都會產生水平規則:

* * *

***

*****

- - -

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

圖片

Markdown 使用的圖片語法旨在模仿連結語法,共有兩種樣式可用:「內嵌」和「參照」。

每張圖片都具有下列屬性:

  • 開頭驚嘆號:!
  • 一組方括號,內含 alt 屬性文字。
  • 一組括號,內含圖片的網址或路徑,以及以雙引號或單引號括住的 title 屬性。
  • 使用自訂屬性語法 {: .my-custom-css-class} 的選用類別組合

內嵌語法

以下為有效的內嵌圖片語法:

![Alt text](/docs/images/benchmarking/test_suite_example.png)

![Alt text](/docs/images/benchmarking/test_suite_example.png "Optional title")

![Alt text](/docs/images/benchmarking/test_suite_example.png "Optional title"){: .my-custom-css-class} 

參考語法

以下是參照樣式圖片語法:

![Alt text][ID]

其中 ID 是已定義圖片參照的名稱。圖片參照則是使用類似於連結參照的語法來定義。

[ID]: docs/images/benchmarking/test_suite_example.png  "Optional title attribute"

自訂語法

您可以使用下列語法指定 Markdown 圖片的寬度:

![Alt text](/docs/images/benchmarking/test_suite_example.png){: width="123"} 

加入程式碼

includecode 標記包含其他檔案的文字區塊,尤其是來源程式碼區塊。這個標記也可以在文字中產生可下載的檔案,而非在文件中加入文字。

您可以使用這個標記,將部分原始碼插入文件中,並將該原始碼維護為可執行檔案。

gerrit_repo+path 參數是指在 Gerrit 或 Git 上託管的存放區和路徑。repo 的格式為 instance or repositorypath 的格式為 path/to/file

{% includecode gerrit_repo="fuchsia/fuchsia" gerrit_path="examples/fidl/fuchsia.examples/types.test.fidl" %}

納入檔案的部分內容

您可以透過三種方式指定檔案的區域:區域標記、規則運算式和縮排區塊。

區域標記

區域標記可讓您在來源檔案中新增行,指出區域的第一行和最後一行,以及標記名稱。

{% includecode gerrit_repo="fuchsia/fuchsia" gerrit_path="examples/fidl/fuchsia.examples/types.test.fidl" region_tag="consts" %}

已算繪:

const BOARD_SIZE uint8 = 9;
const NAME string = "Tic-Tac-Toe";

規則運算式

您也可以使用 regexp 參數,透過規則運算式定義要擷取的區域。例如:

{% includecode gerrit_repo="fuchsia/fuchsia" gerrit_path="examples/fidl/fuchsia.examples/types.test.fidl" regexp="WRITE = 0b010;" %}

已算繪:

WRITE = 0b010;

模式會使用 Python 規則運算式語法。詳情請參閱官方 Python 說明文件

縮排區塊

您可以加入函式或類別定義的程式碼,而無需定義區域標記。使用 indented_block 參數:

{% includecode gerrit_repo="fuchsia/fuchsia" gerrit_path="examples/fidl/fuchsia.examples/types.test.fidl" indented_block="type User" %}

已算繪:

type User = table {
    1: age uint8;
    2: name string:MAX_STRING_LENGTH;
};

模式會使用 Python 規則運算式語法。詳情請參閱官方 Python 說明文件

參數

以下是 includecode 的選用參數:

Markdown

參數
highlight 選用
您可以使用 highlight 參數,將注意力集中在程式碼的特定部分。使用半形逗號分隔的值,指出您要醒目顯示的資料行。行號是相對於所選區域,而非整個檔案。

範例
{% includecode gerrit_repo="fuchsia/fuchsia" gerrit_path="examples/fidl/fuchsia.examples/types.test.fidl" region_tag="bits" highlight="2,3,4" %}
adjust_indentation 選用
預設情況下,includecode 會傳回原始碼的指定部分,包括空白字元。您可以使用 adjust_indentation 選項調整程式碼的縮排。

adjust_indentation 可接受兩個值:
  • number - 整數。這會指出每行要取消縮排的空格數量。舉例來說,如果值為 4,則會將行縮排 4 個空格,而 -2 則會將行縮排 2 個空格。
  • 'auto' - 字串 auto。發布工具會根據區域中找到的開頭空格最小數量,將所選程式碼的縮排取消。換句話說,它會移除程式碼片段中所有行程式碼的前置空格。
範例
{% includecode gerrit_repo="fuchsia/fuchsia" gerrit_path="examples/fidl/fuchsia.examples/types.test.fidl" region_tag="bits" adjust_indentation="-2" %}
html_escape 選用
根據預設,includecode 會為所有程式碼加上 HTML 轉義。您可以將 html_escape 設為 False,以便取消 HTML 轉義。

範例
{% includecode gerrit_repo="fuchsia/fuchsia" gerrit_path="examples/fidl/fuchsia.examples/echo.test.fidl" region_tag="launcher" html_escape="False" %}
exclude_regexp 選用
您可以根據規則運算式移除特定行。這項功能可用於移除留言或其他不相關的內容。您無法使用多行規則。

範例
{% includecode gerrit_repo="fuchsia/fuchsia" gerrit_path="examples/fidl/fuchsia.examples/types.test.fidl" region_tag="bits" exclude_regexp="READ" %}

已算繪

參數
highlight highlight="2,3,4" 之前:
        bits FileMode : uint16 {
          READ = 0b001;
          WRITE = 0b010;
          EXECUTE = 0b100;
        };
highlight="2,3,4" 後:
        bits FileMode : uint16 {
          READ = 0b001;
          WRITE = 0b010;
          EXECUTE = 0b100;
        };
adjust_indentation adjust_indentation="-2" 之前:
        bits FileMode : uint16 {
          READ = 0b001;
          WRITE = 0b010;
          EXECUTE = 0b100;
        };
adjust_indentation="-2" 後:
            bits FileMode : uint16 {
              READ = 0b001;
              WRITE = 0b010;
              EXECUTE = 0b100;
            };
html_escape html_escape="False" 之前:
MAX_STRING_LENGTH echo_prefix, request<Echo> request);
html_escape="True" 後:
MAX_STRING_LENGTH echo_prefix, request request);
exclude_regexp exclude_regexp="READ" 之前:
      bits FileMode : uint16 {
        READ = 0b001;
        WRITE = 0b010;
        EXECUTE = 0b100;
      };
exclude_regexp="READ" 後:
      bits FileMode : uint16 {
        WRITE = 0b010;
        EXECUTE = 0b100;
      };

納入 Markdown 片段

您可以使用 << >> 指令 (包含必要檔案路徑),將 Markdown 檔案納入目前的 Markdown 檔案,以便進行正常處理。路徑必須相對於目前的 .md 來源檔案,請勿使用絕對路徑。<< >> 指令是區塊指令,因此必須單獨出現在一個行中。

舉例來說,如果目前檔案 en/time-travel/example.md 想要包含檔案 en/time-travel/_samples/_sample.md,則會指定:

<<_samples/_sample.md>>

內嵌程式碼

您可以使用反引號 (`) 包住文字,在 Markdown 段落中指明程式碼。

Markdown

Use the `printf()` function. Code for the `printf()` function is located in the `system\ ` directory.

This sentence has inline `  {code}    ` with a lot of spaces but none are rendered.

產生的 HTML

<p>Use the <code>printf()</code> function. Code for the <code>printf()</code>
function is located in the <code>system\</code> directory.</p>
<p>This sentence has inline <code>{code}</code>with a lot of spaces but none
are rendered.</p>

已算繪

使用 printf() 函式。printf() 函式的程式碼位於 system\ 目錄中。

這個句子內含許多空格的內嵌 {code},但系統不會顯示任何空格。

內嵌 HTML

Markdown 語法不提供 HTML 的完整多樣性,但支援內嵌 HTML。您可以將文字納入 HTML 元素標記中,例如:

Markdown

This sentence is in Markdown with a <b>bold inline HTML tag</b>.

已算繪

這句話是使用 Markdown 和粗體內嵌 HTML 標記寫成的。

Fuchsia.dev 支援三種連結樣式:內嵌參照外部。在所有樣式中,連結文字會以 [] (方括號) 分隔。

如要建立內嵌連結,請在連結文字結尾方括號後方接著加入一組一般括號。在括號內加入你希望連結指向的網址,以及連結標題 (選用),並使用引號括住,例如:

Markdown

This is [an example](https://fuchsia.dev/ "Title") inline link.

[This link](https://fuchsia.dev/) has no title attribute.

產生的 HTML

<p>This is <a href="https://fuchsia.dev/" title="Title">
an example</a> inline link.</p>

<p><a href="fuchsia.dev">This link</a> has no
title attribute.</p>

已算繪

這是內嵌連結的範例。

這個連結沒有 title 屬性。

如果您要轉介到本機資源 (例如來源樹狀結構中的檔案),可以使用相對路徑。如需範例,請參閱說明文件 README

參照樣式連結會使用第二組方括號,在這組方括號內,你必須提供標籤來識別連結:

This is [an example][id] reference-style link.

您可以自行選擇使用空格來分隔括號組:

This is [an example] [id] reference-style link.

接著,您可以在文件底部定義連結,並在單一行中輸入連結:

[id]: https://{{example_url}}/  "Optional Title Here"

您可以將 {: .external} 新增至語法,提醒讀者連結會導向外部網站。例如:

See the [official documentation](https://my_external_website){: .external} for details.

連結至 Fuchsia 原始碼或 Fuchsia 變更的連結不是外部連結。

無論您在內容中建立 Markdown 連結的方式為何,您都可以從 Fuchsia.dev 連結至各種類型的內容:

  • 貢獻者在 Fuchsia 來源樹狀結構的 //docs 目錄中建立的內容。

    範例:這是 //docs/get-started/learn-fuchsia.md 的連結:

    [Learn Fuchsia](/docs/get-started/learn-fuchsia.md)
    
  • 自動產生的內容,例如 fuchsia.dev/reference,這類內容不會出現在 Fuchsia 來源樹狀結構中。

    範例:這是 fuchsia.bluetooth 產生的 API 參考資料說明文件連結:

    [`fuchsia.bluetooth`](https://fuchsia.dev/reference/fidl/fuchsia.bluetooth)
    

    Fuchsia 也有位於 //docs/reference/ 目錄的非產生參考內容。這類內容可使用 Fuchsia 來源樹狀結構內容語法建立連結。

  • 連結至網址。這類連結必須標示為「External」

    範例:這是 google.com 的連結:

    [`google.com`](https://google.com){: .external} 
    

清單

使用 Markdown 語法,即可輕鬆建立項目符號或編號清單。這些通常稱為未排序 (項目符號) 或排序 (編號) 清單,因為它們會參照產生的 (<ul>) 和 (<ol>) HTML 標記。

未排序的清單

未排序的清單可以使用星號 (*)、加號 (+) 或破折號 (-) 做為清單標記。無論您使用哪個標記,清單都會以相同方式顯示。

Markdown

This is a Markdown paragraph:
                                             // required blank line
* Red
* Green
* Blue

This is another Markdown paragraph:
                                            // required blank line
+ Red
+ Green
+ Blue

This is yet another Markdown paragraph:
                                            // required blank line
- Red
- Green
- Blue

產生的 HTML

<p>This is a Markdown paragraph:</p>
<ul>
  <li>Red</li>
  <li>Green</li>
  <li>Blue</li>
</ul>
<p>This is another Markdown paragraph:</p>
<ul>
  <li>Red</li>
  <li>Green</li>
  <li>Blue</li>
</ul>
<p>This is yet another Markdown paragraph:</p>
<ul>
  <li>Red</li>
  <li>Green</li>
  <li>Blue</li>
</ul>

已算繪

這是 Markdown 段落:

  • 紅色
  • Green
  • Blue

這是另一個 Markdown 段落:

  • 紅色
  • Green
  • Blue

這是另一個 Markdown 段落:

  • 紅色
  • Green
  • Blue

多層次的未排序清單

在多層次的無序清單中,您可以使用星號 (*)、加號 (+) 或破折號 (-) 做為清單標記。在第二層標記之前,至少要留四個空格,且每個層級都必須一致。請參考以下範例:

Markdown

This is a Markdown paragraph:
                              // required blank line before parent list
 * Bird
     * Celtics
     * Retired
       * Larry                // extra space; not consistent w/ "Celtics"
 * Magic
     * Lakers

產生的 HTML

<p>This is a Markdown paragraph:</p>
<ul>
  <li>Bird
    <ul>
      <li>Celtics</li>
      <li>Retired</li>
      <ul>
        <li>Larry</li>
      </ul>
    </ul>
  </li>
  <li>Magic
    <ul>
      <li>Lakers</li>
    </ul>
  </li>
</ul>

已算繪

這是 Markdown 段落:

    • Celtics
    • 已淘汰
      • Larry
  • 魔術
    • Lakers

已排序的清單

排序清單會在清單項目前使用數字和句號。您可以在排序清單中定義自己的序數,也可以使用 1. 自動編號。請參考以下範例:

Markdown

This is a Markdown paragraph:
                                   // required blank line
1. Bird                            // recommended numbering
1. McHale
1. Parish

This is another Markdown paragraph:
                                   // required blank line
1. Bird                            // sequential numbering is allowed,
2. McHale                          // but not recommended
3. Parish

This is yet another Markdown paragraph:
                                   // required blank line
3. Bird                            // non-sequential numbering is allowed,
1. McHale                          // but not recommended
8. Parish

產生的 HTML

<p>This is a Markdown paragraph:</p>
<ol>
  <li>Bird</li>
  <li>McHale</li>
  <li>Parish</li>
</ol>
<p>This is another Markdown paragraph:</p>
<ol>
  <li>Bird</li>
  <li>McHale</li>
  <li>Parish</li>
</ol>
<p>This is yet another Markdown paragraph:</p>
<ol>
  <li>Bird</li>
  <li>McHale</li>
  <li>Parish</li>
</ol>

已算繪

這是 Markdown 段落:

  1. Bird
  2. McHale
  3. 教區

這是另一個 Markdown 段落:

  1. Bird
  2. McHale
  3. 教區

這是另一個 Markdown 段落:

  1. Bird
  2. McHale
  3. 教區

多層級排序清單

你可以建立多層次的排序清單,但第二層標記前必須至少有四個空格。

Markdown

 1. Bird
     1. Lakers
 1. McHale
     1. Celtics

產生的 HTML

<ol>
  <li>Bird
    <ol>
      <li>Lakers</li>
    </ol>
  </li>
  <li>McHale
    <ol>
      <li>Celtics</li>
    </ol>
  </li>
</ol>

已算繪

    1. Lakers
  1. 阿海
    1. Celtics

MathJax

<devsite-mathjax> 自訂元素可讓您使用 MathJax 2.7 在 fuchsia.dev 內容中顯示數學符號。MathJax 會使用 LaTeX 語法建立數學概念。詳情請參閱 LaTeX 語法指南

用量

如要在文件中使用 MathJax,您必須在文件中加入自訂元素:

  {# To see the fully rendered MathJax equations on this page,
  see the published page at https://fuchsia.dev/<PATH_TO_YOUR_DOCUMENT>#}
  <devsite-mathjax config="TeX-AMS-MML_SVG"></devsite-mathjax>

加入自訂元素後,您就可以在 $$ block or $ inline.

Standalone block

Markdown

<!-- <devsite-mathjax config="TeX-AMS-MML_SVG"></devsite-mathjax> -->

<div>
  $$
  R_{\mu\nu}-\frac{1}{2}Rg_{\mu\nu}+\Lambda{g_{\mu\nu}} = \frac{8\pi{G}}{c^4}{T_{\mu\nu}}
 $$
</div>

Rendered

$$ R_{\mu\nu}-\frac{1}{2}Rg_{\mu\nu}+\Lambda{g_{\mu\nu}} = \frac{8\pi{G}}{c^4}{T_{\mu\nu}} $$ 中寫入數學概念

Inline

Markdown

<!--Included only one time previously-->
<devsite-mathjax config="TeX-AMS-MML_SVG"></devsite-mathjax>

The area of a circle can be computed using the equation $ A = \pi{r^2} $,
where $ r $ is the radius of the circle, and $ \pi $ is the mathematical
constant that is approximately equal to 3.14159.

Rendered

The area of a circle can be computed using the equation $ A = \pi{r^2} $, where $ r $ is the radius of the circle, and $ \pi $ is the mathematical constant that is approximately equal to 3.14159.

Paragraphs

A paragraph is simply one or more consecutive lines of text, separated by one or more blank lines. (A blank line is any line that looks like a blank line -- a line containing nothing but spaces or tabs is considered blank.) You do not need to indent normal paragraphs with spaces or tabs.

Tables

Markdown makes it easy to format tables with pipes (|) and hyphens (-). Deliminate text with pipes to create columns; a header row is defined when the following row has at least three hyphens for each column header.

Markdown

Lesson                     | Description
------------------------   | ---------------------------------------
What is Fuchsia?           | An open source effort to create a production-grade operating system
What is FIDL?              | Fuchsia Interface Definition Language
Getting Started            | Download the Fuchsia source code

Generated HTML

<table>
  <thead>
    <tr>
      <th>Lesson</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>What is Fuchsia?</td>
      <td>An open source effort to create a production-grade operating system</td>
    </tr>
    <tr>
      <td>What is FIDL?</td>
      <td>Fuchsia Interface Definition Language</td>
    </tr>
    <tr>
      <td>Getting Started</td>
      <td>Download the Fuchsia source code</td>
    </tr>
  </tbody>
</table>

Rendered

Lesson Description
What is Fuchsia? An open source effort to create a production-grade operating system
What is FIDL? Fuchsia Interface Definition Language
Getting Started Download the Fuchsia source code

Formatting text in a table

You can use Markdown syntax to format text within a table (that is, *emphasis*, **strong**, `code`). To align text within a column, add a colon : in the dash --- row to indicate direction (that is, left, center, right) as in the example below:

Markdown

Left-aligned     | Center-aligned | Right-aligned
:---             |     :---:      |          ---:
info             | info           | info
more info        | more info      | more info
even *more* info | some `code`    | **not** code

Rendered

Left-aligned Center-aligned Right-aligned
info info info
more info more info more info
even more info some code not code