按照Chris大的教學改造了Hexo
現在來測試下效果,測試碼來自HackMd
失效的部分:
slideshare、speakerdeck、PDF、Font-Awesome icon
MahtJax、UML 圖表、警告區塊
程式碼區塊抓取有點問題,一定要換行
引用區塊標籤
失敗
接續上一個程式碼區塊的行號,使用 =+
失敗
內部頁面用hashtag連結 #title
,跳轉會失敗(經過測試,是Theme的問題)
無痕模式下 imgur 圖床的圖片無法顯示
● 以下為測試碼
● 功能介紹
請不要修改這份筆記 非常謝謝您 😄
如果要說 嗨 或是 玩些東西,請至 遊樂場
● 特賣會
歡迎來自 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 | ✔ | ✖ | ✖ | ✖ | ✖ |
只有筆記的擁有者可以更改權限
● 嵌入
1 | <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]
將目錄嵌入到您的筆記之中
[TOC]
● 表情符號
您可以像是這樣使用表情符號 😄 😃 😢 😉
完整的表情符號列表 在這裡
● 待辦清單
● 程式碼區塊
我們支援非常多程式語言,使用自動完成來看看有些什麼
1 | var s = "JavaScript syntax highlighting"; |
如果想要 行號,在表明程式語言之後輸入
=
您也可以指定開始行號,如下所示,行號從101開始
1 | var s = "JavaScript syntax highlighting"; |
或是可以接續上一個程式碼區塊的行號,使用
=+
1 | var s = "JavaScript syntax highlighting"; |
● 引用區塊標籤
您可以使用以下語法,表明自己的 姓名、時間與顏色 並與其他的引用區塊做區別
[name=ChengHan Wu] [time=Sun, Jun 28, 2015 9:59 PM] [color=#907bf7]也支援巢狀引用區塊喔!
[name=ChengHan Wu] [time=Sun, Jun 28, 2015 10:00 PM] [color=red]
● 外部
● Youtube
● Vimeo
● Gist
● SlideShare
1 | {%slideshare briansolis/26-disruptive-technology-trends-2016-2018-56796196 %} |
This is not worked!
● Speakerdeck
1 | {%speakerdeck sugarenia/xxlcss-how-to-scale-css-and-keep-your-sanity %} |
This is not worked!
注意:請使用 https 的網址,否則可能會被您的瀏覽器阻擋載入
1 | {%pdf https://papers.nips.cc/paper/5346-sequence-to-sequence-learning-with-neural-networks.pdf %} |
This is not worked!
● MathJax
您可以使用 MathJax 語法 來產生 LaTeX 數學表達式,如同 math.stackexchange.com,但是開始的 $
後面以及結尾的 $
前面不能有空白:
The Gamma function satisfying is via the Euler integral
更多關於 LaTeX 數學表達式 請至這裡
● UML 圖表
● 循序圖
您可以像是以下使用循序圖:
● 流程圖
您可以像是以下使用流程圖:
● Graphviz
1 | digraph hierarchy { |
● Mermaid
1 | gantt |
● Abc
1 | X:1 |
更多關於 循序圖 語法 在這裡.
更多關於 流程圖 語法 在這裡.
更多關於 graphviz 語法 在這裡
更多關於 mermaid 語法 在這裡
更多關於 abc 語法 在這裡
● 警告區塊
耶 🎉
這是訊息 📣
注意 ⚡️
喔不 🔥
● 排版
● 標頭
1 | # h1 標頭 |
● 水平分隔線
● 字形替換
© © ® ® ™ ™ § § ±
測試… 測試… 測試… 測試?.. 測試!..
!!! ??? ,
Remarkable – awesome
“Smartypants, 雙引號”
‘Smartypants, 單引號’
● 強調
這是粗體文字
這是粗體文字
這是斜體文字
這是斜體文字
這是刪除文字
上標: 19th
下標: H2O
這是底線文字
這是標記文字
● 引用區塊
引用區塊也可以是巢狀的喔…
…可以多層次的使用…
…或是用空白隔開
● 清單
● 項目
- 在行開頭使用
+
-
或是*
來建立清單 - 空兩個空白就可以產生子清單
- 當清單標記使用的字元不同,會強制建立新的清單
- Ac tristique libero volutpat at
- Facilisis in pretium nisl aliquet
- Nulla volutpat aliquam velit
- 當清單標記使用的字元不同,會強制建立新的清單
- 非常簡單!
● 編號
-
Lorem ipsum dolor sit amet
-
Consectetur adipiscing elit
-
Integer molestie lorem at massa
-
您可以逐次增加項目數字…
-
…或是全部都使用
1.
-
feafw
-
332
-
242
-
2552
-
e2
從其他範圍開始編號清單
- foo
- bar
● 程式碼
行內 程式碼
縮排程式碼
// Some comments
line 1 of code
line 2 of code
line 3 of code
程式碼區塊
1 | Sample text here... |
語法標色
1 | var foo = function (bar) { |
● 表格
選項 | 描述 |
---|---|
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”,不受影響