IntelliJ IDEA使用之Markdown

Markdown

默認(rèn)情況下，在IntelliJ IDEA中安裝并激活了Markdown支持插件。 

Markdown是一種輕量級(jí)標(biāo)記語言，用于向純文本添加格式元素。IntelliJ IDEA提供專用的Markdown編輯器，并在實(shí)時(shí)預(yù)覽中顯示呈現(xiàn)的HTML。

Markdown編輯器可幫助您執(zhí)行基本編輯功能：管理標(biāo)題，將格式應(yīng)用于文本以使其變?yōu)榇煮w或斜體等。您還可以使用完成功能添加指向其他項(xiàng)目文檔或圖像的鏈接，插入各種編程語言的代碼塊，以及可視化DOT或PlantUML圖表。

預(yù)覽

默認(rèn)情況下，Markdown編輯器分為代碼編輯器和預(yù)覽窗格。如有必要，您只能使用或 按鈕顯示代碼編輯器或預(yù)覽 。

您還可以管理編輯器和預(yù)覽窗格是垂直拆分還是水平拆分。為此，請(qǐng)打開“設(shè)置/首選項(xiàng)”對(duì)話框（Ctrl+Alt+S），轉(zhuǎn)到“語言和框架|Markdown”頁面并使用“編輯器”和“預(yù)覽面板布局”選項(xiàng)。

IntelliJ IDEA自動(dòng)將預(yù)覽與代碼編輯器中的當(dāng)前插入位置同步。您可以使用“自動(dòng)滾動(dòng)預(yù)覽”按鈕（）來管理此功能。

文檔導(dǎo)航

在markdown文檔中導(dǎo)航的有用方法是結(jié)構(gòu)視圖。它顯示文檔標(biāo)題，并允許您快速跳轉(zhuǎn)到所需的段落。

您可以在“結(jié)構(gòu)”工具窗口（Alt+7）和“文件結(jié)構(gòu)”彈出窗口（Ctrl+F12）之間進(jìn)行選擇。

格式化

在Markdown編輯器中，您可以將基本格式應(yīng)用于文本。例如，為了使所選擇的文本變?yōu)榇煮w，斜體或等寬，請(qǐng)分別使用，和 按鈕。

項(xiàng)目文件的鏈接

Markdown編輯器提供了對(duì)當(dāng)前項(xiàng)目中包含的文件的鏈接的完成。例如，這可以是其他markdown文檔或圖像。

如果在項(xiàng)目中找不到鏈接文件，Markdown編輯器將發(fā)出警告。

代碼塊

編輯器允許您通過在代碼塊之前和之后放置三個(gè)反引號(hào)（```）來為不同語言插入受限代碼塊。

所選語言支持代碼完成，檢查和意圖操作。

如果不需要這些功能，則可以禁用markdown文件的代碼注入。要執(zhí)行此操作，請(qǐng)打開“設(shè)置/首選項(xiàng)”（Ctrl+Alt+S），轉(zhuǎn)到“語言和框架|Markdown”頁面并使用代碼欄中的禁用自動(dòng)語言注入選項(xiàng)。

圖

IntelliJ IDEA支持使用DOT和PlantUML圖表語言在Markdown預(yù)覽中可視化圖表。

請(qǐng)注意，您需要安裝PlantUML框架來呈現(xiàn)圖表。要執(zhí)行此操作，請(qǐng)打開“設(shè)置/首選項(xiàng)”（Ctrl+Alt+S），轉(zhuǎn)到“語言和框架|Markdown”頁面并單擊“PlantUML框架未安裝”警告旁邊的Install按鈕。該框架將安裝到IntelliJ IDEA緩存中。

要顯示圖表，請(qǐng)使用puml或plantuml語言插入相應(yīng)的代碼塊。您可以復(fù)制下面的代碼段以查看此功能的實(shí)際效果。 

• PlantUML

  ```puml
  A -> B
  ```

• DOT

  ```plantuml
  digraph Test {
  A -> B
  }
  ```

用于預(yù)覽的自定義CSS

Markdown預(yù)覽允許您使用自定義樣式表來呈現(xiàn)文檔。您可以指定自定義樣式表以進(jìn)行基本演示文稿更改（例如，在預(yù)覽中增加字體大?。?，也可以提供全新的CSS（例如，如果要復(fù)制GitHub Markdown樣式）。

要提供自定義樣式表，請(qǐng)打開“設(shè)置/首選項(xiàng)”對(duì)話框（ Ctrl+Alt+S），轉(zhuǎn)到“語言和框架|Markdown”頁面并使用“從URI加載”選項(xiàng)設(shè)置所需CSS文件的路徑。此路徑可以是HTTP/HTTPS URL或絕對(duì)/相對(duì)路徑。

或者，在Add CSS rules編輯器中直接指定CSS 。