# Markdown語法使用教學 這篇簡介會來跟大家介紹Markdown是甚麼，以及怎樣是最容易上手的Markdown語法，還有在我們的刊物裡面，為甚麼我們要用Markdown語法來表達。 ## 甚麼是Markdown？為甚麼要用它？ 簡單來說，Markdown就像python、C或Java是一套語言和規則，但是是用來作出文字上的表現。我們可以透過Markdown語法來進行很多的文字呈顯，像是*斜體*、**粗體**、~~刪除線~~等等。 比方說下面這段文字： > 「*...在工具與神話之間，儀器與概念之間，社會關係的歷史系統和可能身體（包括知識客體）的歷史解剖之間，**邊界是深具滲透性的**。確實，神話和工具相互構成彼此*」——引自Haraway(1985)《**賽博格宣言**》，重點為作者加註。 在Markdown語法的表現方式是： ``` > 「*...在工具與神話之間，儀器與概念之間，社會關係的歷史系統和可能身體（包括知識客體）的歷史解剖之間，**邊界是深具滲透性的**。確實，神話和工具相互構成彼此*」——引自Haraway(1985)《**賽博格宣言**》，重點為作者加註。 ``` 我們用一些簡單的方式加註出我們要表現的樣式，而程式可以幫我們閱讀這些語言，並且轉換（render）成我們想要呈現的結果。你可以試著點擊左上角的編輯頁面，可以發現這個頁面原始的語法是怎麼打出來的。 至於我們為甚麼要用Markdown語法，是因為我們的刊物主要想要透過Jupyter Book來進行保存。Jupyter是一個大型的計算科學語言計畫，而Jupyter Book是其中的一個部分，是用來呈現簡易而清楚的網頁模板，並且可以對於篇章結構進行分層，類似於[read the docs](https://docs.readthedocs.io/en/stable/)。我們打算把每一期紀錄在同一個網頁中，並且收錄大家的文章在同一期裡面。 ## 建議的Markdown語法編譯器 對於完全沒有接觸過程式語言或是Markdown語法的人，也許很難就背起這些固定的用法，所以這裡提供兩個最簡單的編譯器。 ### Notion 沒錯，就是你平常拿來做筆記的Notion。 原則上，Notion就是遵照Markdown語法設計出來的一套文字編輯網頁，它的方便性在於不需要會這些語法也能夠輕易編輯，只要按下每一行左手邊的加號就能加上所有你想要呈現的東西。 當我們在Notion編輯完一份文件時，我們其實都可以用Markdown的方式把它下載下來，我們需要的是按右上角的點點選項，並拉到最下面的**export** ![image.png](https://hackmd.io/_uploads/SyuTxIS7p.png) 其中有以Markdown格式下載的模式。於是你就在不需要學會Markdown語法的情況下，輸出了一份Markdown語法的文件，恭喜你。 ### HackMD 也就是你目前看到的這個網頁。 HackMD好處除了可以用點擊的方式加上各種表現的語法以外，在撰寫的過程也可以開啟雙欄模式，一邊撰寫一邊預覽，也跟Notion一樣可以輸出成Markdown的檔案。 :::info 相較於Notion，HackMD的好處是免費、易於註冊、很好分享與管理，也很好給註解。因此，我們比較希望大家嘗試使用HackMD來撰寫自己的短文。 ::: ## 一些基本的Markdown語法參考 ### 內文 | | Markdown格式 | 呈現樣態 | | ---- |:------------:|:--------:| | 粗體 | `**粗體**` | **粗體** | | 斜體 | `*斜體*` | *斜體* | | 刪除線 | `~~刪除線~~` | ~~刪除線~~ | ### 標題 ``` # 一號標題 ## 二號標題 ### 三號標題 ``` 呈現出來的樣態如下： # 一號標題 ## 二號標題 ### 三號標題 ### 列點 使用tap來進行分層，與word類似 ``` - 第一層 - 第二層 - 第二層 - 第三層 ``` 呈現出來的樣態如下： - 第一層 - 第二層 - 第二層 - 第三層 ### 引用與醒目提示 ``` :::info 這是一則醒目提示 ::: :::warning 這是一則警告提示 ::: ``` 呈現出來如下： :::info 這是一則醒目提示 ::: :::warning 這是一則警告提示 :::