功能介紹

回到 HackMD 教學首頁

功能回饋 或回報 BUG

English version
中文版
日本語版

請不要修改這份筆記 非常謝謝您

如果要說 嗨 或是 玩些東西，請至 遊樂場

特賣會

歡迎來自 Front-End Developers Taiwan 的各位！

歡迎來自 g0v 的各位！
歡迎來自 程式人雜誌 的各位！

簡介

HackMD 是個跨平台的 Markdown 即時協作筆記
所以您可以在電腦、平板甚至是手機與其他人做筆記！
同時也可以在 首頁 透過 Facebook、Twitter、GitHub、Dropbox 登入

如有任何問題或是狀況，請至 GitHub 回報問題
如果需要即時支援，請使用 Facebook message
謝謝您！

工作區

模式

電腦 & 平板

編輯：只看到編輯器
檢視：只看到結果
同時：同時看到兩邊

手機

檢視：只看到結果
編輯：只看到編輯器

上傳圖片

只要按下這個按鈕
或是 拖放 圖片到編輯器，甚至 貼上 圖片也可以喔！
這會自動上傳圖片至 imgur，啥都不必煩惱了

分享筆記

如果您想分享 可編輯的 筆記，複製這份文件的網址就好
如果您想分享 只可讀的 筆記，按下這個按鈕 然後複製網址

儲存

目前可以儲存至 Dropbox 或是存放 .md 到您的本機

匯入

就像上面的儲存功能，您可以從 Dropbox 匯入 .md
或是從 剪貼簿 匯入，而且這可以轉換 html 喔

權限

檢視右上方有個小按鈕可以修改筆記權限，目前有六種選項：

	擁有者 可讀/寫	已登入者 可讀	已登入者 可寫	訪客 可讀	訪客 可寫
Freely	✔	✔	✔	✔	✔
Editable	✔	✔	✔	✔	✖
Limited	✔	✔	✔	✖	✖
Locked	✔	✔	✖	✔	✖
Protected	✔	✔	✖	✖	✖
Private	✔	✖	✖	✖	✖

只有筆記的擁有者可以更改權限

嵌入

<iframe width="100%" height="500" src="https://hackmd.io/features" frameborder="0"></iframe>

簡報模式

您可以使用一些語法將您的筆記分成投影片
然後用 簡報模式 來展示，詳細請至上連結

書籍模式

您可以將您的筆記彙整成一本書
請將您的筆記連結列成清單
然後用 書籍模式 來展示，詳細請至上連結

檢視

目錄

在右下角有個目錄的小按鈕
按下它會顯示目前的目錄，而且會標明你所在的區塊
支援到第三階段的標頭

永久連結

每個標頭都會在右側自動加上永久連結
您可以在滑到上面並且按 去移到那個錨點

編輯

快速鍵

跟又快又方便的Sublime text很像

更多訊息請至 這裡

自動完成

提供完整的 Markdown 自動完成與提示

• 表情符號：輸入 : 顯示提示
• 程式碼區塊：輸入 ``` 加上一個字元 顯示提示 ```
• 標頭：輸入 # 顯示提示
• 參考：輸入 [] 顯示提示
• 外部：輸入 {} 顯示提示
• 圖片：輸入 ! 顯示提示

標題

會使用 第一個第一級標頭 作為筆記標題

標籤

如同以下方式來使用標籤，它們會顯示在您的 歷史紀錄

tags: 功能 酷 更新

YAML metadata

提供描述筆記的資訊，以進階設定瀏覽行為，詳細請至上連結

• robots: 設定網路機器人 meta
• lang: 設定瀏覽器顯示語言
• dir: 設定文字方向
• breaks: 設定是否使用分行
• GA: 設定 Google Analytics
• disqus: 設定 Disqus
• slideOptions: 設定簡報模式的選項

ToC:

請使用此語法 [TOC] 將目錄嵌入到您的筆記之中

• 功能介紹
• 特賣會
• 簡介
• 工作區
  • 模式
  • 上傳圖片
  • 分享筆記
  • 儲存
  • 匯入
  • 權限
  • 嵌入
  • 簡報模式
  • 書籍模式
• 檢視
  • 目錄
  • 永久連結
• 編輯
  • 快速鍵
  • 自動完成
  • 標題
  • 標籤
  • YAML metadata
  • ToC:
  • 表情符號
  • 待辦清單
  • 程式碼區塊
  • 引用區塊標籤
  • 外部
    • Youtube
    • Vimeo
    • Gist
    • SlideShare
    • Speakerdeck
    • PDF
  • MathJax
  • UML 圖表
    • 循序圖
    • 流程圖
    • Graphviz
    • Mermaid
    • Abc
  • 警告區塊
  • 排版
    • 標頭
    • 水平分隔線
    • 字形替換
    • 強調
    • 引用區塊
    • 清單
    • 程式碼
    • 表格
    • 連結
    • 圖片
    • 註腳
    • 定義清單
    • 縮寫

表情符號

您可以像是這樣使用表情符號

完整的表情符號列表 在這裡

待辦清單

• 待辦
  • 買些沙拉
  • 刷牙
  • 喝水

程式碼區塊

我們支援非常多程式語言，使用自動完成來看看有些什麼

var s = "JavaScript syntax highlighting";
alert(s);
function $initHighlight(block, cls) {
  try {
    if (cls.search(/\bno\-highlight\b/) != -1)
      return process(block, true, 0x0F) + 
             ' class=""';
  } catch (e) {
    /* handle exception */
  }
  for (var i = 0 / 2; i < classes.length; i++) {
    if (checkCondition(classes[i]) === undefined)
      return /\d+[\s/]/g;
  }
}

如果想要 行號，在表明程式語言之後輸入 =
您也可以指定開始行號，如下所示，行號從101開始

var s = "JavaScript syntax highlighting";
alert(s);
function $initHighlight(block, cls) {
  try {
    if (cls.search(/\bno\-highlight\b/) != -1)
      return process(block, true, 0x0F) + 
             ' class=""';
  } catch (e) {
    /* handle exception */
  }
  for (var i = 0 / 2; i < classes.length; i++) {
    if (checkCondition(classes[i]) === undefined)
      return /\d+[\s/]/g;
  }
}

或是可以接續上一個程式碼區塊的行號，使用 =+

var s = "JavaScript syntax highlighting";
alert(s);

引用區塊標籤

您可以使用以下語法，表明自己的 姓名、時間與顏色 並與其他的引用區塊做區別
ChengHan WuSun, Jun 28, 2015 9:59 PM

也支援巢狀引用區塊喔！
ChengHan WuSun, Jun 28, 2015 10:00 PM

外部

Youtube

Vimeo

Gist

	require 'net/http'
	require 'uri'
	# /api/v1/:format/new
	# /api/v1/:format/gists/:user
	# /api/v1/:format/:gist_id
	res = Net::HTTP.post_form(URI.parse('http://gist.github.com/api/v1/xml/new'),
	{ 'files[file1.ab]' => 'CONTNETS',
	'files[file2.ab]' => 'contents' })
	puts res.body

view raw example_gist_create.rb hosted with ❤ by GitHub

	<?xml version="1.0" encoding="UTF-8"?>
	<gists type="array">
	<gist>
	<public type="boolean">true</public>
	<description nil="true"></description>
	<repo>4278</repo>
	<created-at type="datetime">2008-08-06T13:30:32-07:00</created-at>
	</gist>
	</gists>

view raw output.xml hosted with ❤ by GitHub

SlideShare

26 Disruptive & Technology Trends 2016 - 2018 from Brian Solis

Speakerdeck

PDF

注意：請使用 https 的網址，否則可能會被您的瀏覽器阻擋載入

MathJax

您可以使用 MathJax 語法 來產生 LaTeX 數學表達式，如同 math.stackexchange.com，但是開始的 $ 後面以及結尾的 $ 前面不能有空白：

The Gamma function satisfying

$\mathrm{\Gamma }(n)=(n-1)!\mathrm{\forall }n\in \mathbb{N}$ is via the Euler integral

$$x=\frac{-b\pm \sqrt{b^2-4ac}}{2a}.$$

$$\mathrm{\Gamma }(z)={\int }_0^{\mathrm{\infty }}{t}^{z-1}{e}^{-t}dt.$$

更多關於 LaTeX 數學表達式 請至這裡

UML 圖表

循序圖

您可以像是以下使用循序圖：

流程圖

您可以像是以下使用流程圖：

Graphviz

Mermaid

Abc

更多關於 循序圖 語法 在這裡.
更多關於 流程圖 語法 在這裡.
更多關於 graphviz 語法 在這裡
更多關於 mermaid 語法 在這裡
更多關於 abc 語法 在這裡

警告區塊

耶

這是訊息

注意

喔不

點選顯示更多內容

找到我了！

排版

標頭

# h1 標頭
## h2 標頭
### h3 標頭
#### h4 標頭
##### h5 標頭
###### h6 標頭

水平分隔線

---

---

---

字形替換

© © ® ® ™ ™ § § ±

測試.. 測試… 測試… 測試?.. 測試!..

!!! ??? ,

Remarkable – awesome

"Smartypants, 雙引號"

'Smartypants, 單引號'

強調

這是粗體文字

這是粗體文字

這是斜體文字

這是斜體文字

這是刪除文字

上標： 19^th

下標： H₂O

這是底線文字

這是標記文字

引用區塊

引用區塊也可以是巢狀的喔…

…可以多層次的使用…

…或是用空白隔開

清單

項目

• 在行開頭使用 + - 或是 * 來建立清單
• 空兩個空白就可以產生子清單
  • 當清單標記使用的字元不同，會強制建立新的清單
    • Ac tristique libero volutpat at
    • Facilisis in pretium nisl aliquet
    • Nulla volutpat aliquam velit
• 非常簡單！

編號

1. Lorem ipsum dolor sit amet

2. Consectetur adipiscing elit

3. Integer molestie lorem at massa

4. 您可以逐次增加項目數字…

5. …或是全部都使用 1.

6. feafw

7. 332

8. 242

9. 2552

10. e2

從其他範圍開始編號清單

57. foo
58. bar

程式碼

行內 程式碼

縮排程式碼

​​​​// Some comments
​​​​line 1 of code
​​​​line 2 of code
​​​​line 3 of code

程式碼區塊

Sample text here...

語法標色

var foo = function (bar) {
  return bar++;
};

console.log(foo(5));

表格

選項	描述
data	path to data files to supply the data that will be passed into templates.
engine	engine to be used for processing templates. Handlebars is the default.
ext	extension to be used for dest files.

向右對齊

選項	描述
data	path to data files to supply the data that will be passed into templates.
engine	engine to be used for processing templates. Handlebars is the default.
ext	extension to be used for dest files.

向左對齊

選項	描述
data	path to data files to supply the data that will be passed into templates.
engine	engine to be used for processing templates. Handlebars is the default.
ext	extension to be used for dest files.

置中對齊

選項	描述
data	path to data files to supply the data that will be passed into templates.
engine	engine to be used for processing templates. Handlebars is the default.
ext	extension to be used for dest files.

連結

連結文字
加上標題的連結文字
自動轉換連結 https://github.com/nodeca/pica

圖片

如同連結一般，圖片也可以用註腳語法

使用參考，可以在稍後的文件中再定義圖片網址

使用指定的大小顯示圖片

註腳

註腳 1 連結^[1].
註腳 2 連結^[2].
行內註腳^[3] 定義
重複的註腳參考^[2:1].

定義清單

名詞 1

定義 1 快速連續項目

名詞 2 加上 行內標記

定義 2

​​​​​​  { 這些程式碼屬於 定義 2 的一部分 }

定義 2 的第三段落

緊密樣式：

名詞 1

定義 1

名詞 2

定義 2a

定義 2b

縮寫

這是 HTML 的縮寫範例
它會轉換 "HTML"，但是縮寫旁邊其他的部分，例如："xxxHTMLyyy"，不受影響

---

1. 註腳 也可以標記
   還可以有很多段落 ↩︎

2. 註腳 文字 ↩︎ ↩︎

3. 行內註腳的文字 ↩︎