Markdown 教程

Markdown 是一種輕量級標記語言,它允許人們使用易讀易寫的純文本格式編寫文檔。

Markdown 語言在 2004 由約翰·格魯伯(英語:John Gruber)創建。

Markdown 編寫的文檔可以導出 HTML 、Word、圖像、PDF、Epub 等多種格式的文檔。

Markdown 編寫的文檔後綴為 .md, .markdown


Markdown 應用

Markdown 能被使用來撰寫電子書,如:Gitbook。

當前許多網站都廣泛使用 Markdown 來撰寫幫助文檔或是用於論壇上發表消息。例如:GitHub、簡書、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。


編輯器

本教程將使用 VSCode 編輯器來講解 Markdown 的語法,VSCode 支持 MacOS 、Windows、Linux 平台,且包含多種主題。

VSCode 默認集成了 Markdown 文檔編輯插件,原生就支持高亮 Markdown 的語法。

VSCode(全稱:Visual Studio Code)是一款由微軟開發且跨平台的免費源代碼編輯器。

VSCode 實時預覽還需要執行 Markdown: Open Preview to the Side 命令來實現。

在命令窗口輸入 Markdown: Open Preview to the Side 命令:

最終效果:

如果你需要將 markdown 轉為 PDF、圖片、HTML 等格式也可以安裝對應的插件來實現。

你也可以使用我們的在線編輯器來測試:https://c.runoob.com/front-end/712


測試實例

接下來的測試中,我們先在 VSCode 下安裝 Markdown Preview Enhanced 插件來實現更強大的功能。

點擊右側欄擴展按鈕,查找Markdown Preview Enhanced 插件,點擊安裝:

安裝完成後重啟 VSCode。

在 RUNOOB.md 輸入以下代碼:

# RUNOOB Markdown Test
## Hello World!

將該代碼格式粘貼到文件 RUNOOB.md 上,效果如下:

在預覽框中右擊鼠標還提供了各種導出功能:


有用的書籍

《了不起的Markdown》: