HackMD 使用指南

HackMD 使用指南 === ## 簡介 **HackMD** 是一個跨平台的Markdown即時協作筆記。所以你可以和朋友們在**電腦、平板甚至是手機**上同一時間製作你們的筆記。最方便的就是，你可以在 **[首頁](/)** 透過**Facebook、Twitter、GitHub、Dropbox以及Google**來登入**HackMD**。 ## 1.0 分享功能你可以輕易的複製文件的網址來分享此文件。 ## 2.0 權限設置在頁面的右上方有個小按鈕，你可以透過以下選項來更改權限： 隨意：任何人都可以編輯以及瀏覽這份筆記。 可編輯：已經登入的使用者才可以編輯這個筆記。（客人可以瀏覽） 限制：已經登入的使用者可以編輯這個筆記。（禁止客人瀏覽） 鎖定：只有擁有者可以更改這份筆記。（客人可瀏覽） 保護：只有擁有者可以更改這份筆記。（禁止客人瀏覽） 私有：只有擁有者可以更改與檢視這份筆記。 **只有筆記的擁有者可以更改權限。** ## 3.0 模式轉換 **電腦 & 平板** 檢視：只看到結果。 同時：同時看到兩邊。 編輯：只看到編輯器。 **手機** 檢視：只看到結果。 編輯：只看到編輯器。 ## 4.0 匯入和匯出你可以在點擊**Menu**功能後，從 **Dropbox** 、**Google Drive** 、**Gitgist** 匯入 **.md** 或是從**剪貼簿Clipboard** 匯入。至於匯出也一樣如此。 ## 5.0 下載格式你可以將此Markdown文件在下載的時候轉換成以下格式： - MarkDown - HTML - RAW HTML - ODF(beta) ## 6.0 上載圖片上傳圖片只要按下這個按鈕 或是 **拖放** 圖片到編輯器，甚至 **貼上** 圖片也可以喔！這會自動上傳圖片至 **[imgur](http://imgur.com)**，啥都不必煩惱了 :tada: ![](https://i.imgur.com/9cgQVqD.png) ## 7.0 Emoji功能你可以在**HackMD**自由的使用表情符號 :smile: :smiley: :cry: :wink: > 完整的表情符號列表 [在這裡](http://www.emoji-cheat-sheet.com/) ## 8.0 簡報模式&書本模式除此之外，**HackMD**還具備了讓你將MarkDown文件變成**簡報模式**和**書本模式**的功能。那樣你就可以直接用此來進行你的Presentation或者輕鬆的向看電子書那樣，閱讀你的MarkDown文件。 ## 9.0 目錄功能在“**同時模式**”裡面，你可以再右下角找到目錄的小按鈕 。當你按下之後，他會顯示出你當前所在的區塊，以及完整的目錄表。若想跳轉到其他區塊，你只需要點擊目錄裡面列出的章節題目就可。 ## 10.0 Sublime Text快捷鍵 >可以在這[網站]((https://codemirror.net/demo/sublime.html))找到一些快捷鍵來提升你的文件處理的效率。 > ## 11.0 Markdown自動完成功能提供完整的 Markdown 自動完成與提示。 - 表情符號：輸入 `:` 顯示提示 - 程式碼區塊：輸入 ` ``` ` 加上一個字元顯示提示 - 標頭：輸入 `#` 顯示提示 - 參考：輸入 `[]` 顯示提示 - 外部：輸入 `{}` 顯示提示 - 圖片：輸入 `!` 顯示提示 ## 12.0 程式碼區塊我們支援非常多程式語言，使用自動完成來看看有些什麼。 ```javascript 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開始。 ```javascript=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; } } ``` > 或是可以接續上一個程式碼區塊的行號，使用 `=+`。 ```javascript=+ var s = "JavaScript syntax highlighting"; alert(s); ``` 本人用Python Code的例子： ```python import sys from sympy.solvers import solve from sympy import Symbol # This comes from https://github.com/sourcekris/RsaCtfTool/blob/master/wiener_attack.py # He made it, and I am incorporating it into my Factorizer. # A reimplementation of pablocelayes rsa-wiener-attack for this purpose # https://github.com/pablocelayes/rsa-wiener-attack/ class WienerAttack(object): def rational_to_contfrac (self, x, y): a = x//y if a * y == x: return [a] else: pquotients = self.rational_to_contfrac(y, x - a * y) pquotients.insert(0, a) return pquotients ``` ## 13.0 標籤如同以下方式來使用標籤，它們會顯示在您的**歷史紀錄**。 ###### tags: `筆記` `教程` `作業` ## 14.0 [YAML metadata](./yaml-metadata) 提供描述筆記的資訊，以進階設定瀏覽行為，詳細請至上連結。 - robots: 設定網路機器人 meta。 - lang: 設定瀏覽器顯示語言。 - dir: 設定文字方向。 - breaks: 設定是否使用分行。 - mathjax: 設定是否使用 mathjax。 ## 15.0 清單功能 - [ ] 待辦 - [x] 打東東 - [x] 喝果汁 - [ ] 玩CTF ## 16.0 引用區塊標籤 > 你可以使用以下語法，表明自己的 **姓名、時間與顏色** 並與其他的引用區塊做區別。 > [name=Milo] [time=Sun, October 22, 2017 9:59 PM] [color=#907bf7] > > 也支援巢狀引用區塊喔！ > > [name=Milo] [time=Sun, October 22, 2017 10:00 PM] [color=red] > > ## 17.0 視頻 - Youtube {%youtube CJ9xqHAdFjM %} - Vimeo {%vimeo 230308008 %} ### 18.0 Gist {%gist schacon/4277%} ### 19.0 SlideShare {%slideshare HacksInTaiwan/ctf-56046764 %} ### 20.0 Speakerdeck {%speakerdeck sugarenia/xxlcss-how-to-scale-css-and-keep-your-sanity %} ### 21.0 PDF **注意：請使用 https 的網址，否則可能會被您的瀏覽器阻擋載入。** {%pdf https://beginners.re/RE4B-EN.pdf %} ## 22.0 MathJax 你可以使用 **MathJax** 語法來產生 *LaTeX* 數學表達式，如同 [math.stackexchange.com](http://math.stackexchange.com/)： The *Gamma function* satisfying $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$ is via the Euler integral $$ x = {-b \pm \sqrt{b^2-4ac} \over 2a}. $$ $$ \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. $$ > 更多關於 **LaTeX** 數學表達式 [請至這裡](http://meta.math.stackexchange.com/questions/5020/mathjax-basic-tutorial-and-quick-reference) > ## 23.0 UML 圖表 ### 循序圖您可以像是以下使用循序圖： ```sequence 艾莉絲->包柏: 哈摟，你好嗎？ Note right of 包柏: 包柏思考中包柏-->艾莉絲: 我很好，謝謝！ Note left of 艾莉絲: 艾莉絲回應艾莉絲->包柏: 最近過得怎樣？ ``` ### 流程圖您可以像是以下使用流程圖： ```flow st=>start: 開始 e=>end: 結束 op=>operation: 我的操作 op2=>operation: 啦啦啦 cond=>condition: 是或否？ st->op->op2->cond cond(yes)->e cond(no)->op2 ``` ### Graphviz ```graphviz digraph hierarchy { nodesep=1.0 // increases the separation between nodes node [color=Red,fontname=Courier,shape=box] //All nodes will this shape and colour edge [color=Blue, style=dashed] //All the lines look like this Headteacher->{Deputy1 Deputy2 BusinessManager} Deputy1->{Teacher1 Teacher2} BusinessManager->ITManager {rank=same;ITManager Teacher1 Teacher2} // Put them on the same level } ``` ### Mermaid ```mermaid gantt title A Gantt Diagram section Section A task :a1, 2014-01-01, 30d Another task :after a1 , 20d section Another Task in sec :2014-01-12 , 12d anther task : 24d ``` > 更多關於 **循序圖** 語法 [在這裡](http://bramp.github.io/js-sequence-diagrams/). > 更多關於 **流程圖** 語法 [在這裡](http://adrai.github.io/flowchart.js/). > 更多關於 **Graphviz** 語法 [在這裡](http://www.tonyballantyne.com/graphs.html) > 更多關於 **Mermaid** 語法 [在這裡](http://knsv.github.io/mermaid) > ## 24.0 警告區塊 :::success 成功板塊 ::: :::info 公佈信息 ::: :::warning 注意一下 ::: :::danger 危險地帶 ::: ## 25.0 排版功能 ### 標題 ``` # h1 標頭 ## h2 標頭 ### h3 標頭 #### h4 標頭 ##### h5 標頭 ###### h6 標頭 ``` ### 水平分隔線 ___ --- *** ### 字形替換 (c) (C) (r) (R) (tm) (TM) (p) (P) +- 測試.. 測試... 測試..... 測試?..... 測試!.... "Smartypants, 雙引號" 'Smartypants, 單引號' ### 強調 **這是粗體文字** __這是粗體文字__ *這是斜體文字* _這是斜體文字_ ~~這是刪除文字~~ 上標： 19^th^ 下標： H~2~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 1. 您可以逐次增加項目數字... 1. ...或是全部都使用 `1.` 1. feafw 2. 332 3. 242 4. 2552 1. e2 從其他範圍開始編號清單 57. foo 1. bar ### 程式碼行內 `程式碼` 縮排程式碼 // Some comments line 1 of code line 2 of code line 3 of code 程式碼區塊 ``` Sample text here... ``` 語法標色 ``` javascript 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. | ### 26.0 連結 [連結文字](http://dev.nodeca.com) [加上標題的連結文字](http://nodeca.github.io/pica/demo/ "標題文字！") ### 27.0 圖片 ![Minion](https://octodex.github.com/images/minion.png) ![Stormtroopocat](https://octodex.github.com/images/stormtroopocat.jpg "The Stormtroopocat") 如同連結一般，圖片也可以用註腳語法 ![Alt text][id] 使用參考，可以在稍後的文件中再定義圖片網址 [id]: https://octodex.github.com/images/dojocat.jpg "The Dojocat" ![Minion](https://octodex.github.com/images/minion.png =200x200) 使用指定的大小顯示圖片 ### 註腳註腳 1 連結[^first]. 註腳 2 連結[^second]. 行內註腳^[行內註腳的文字] 定義重複的註腳參考[^second]. [^first]: 註腳 **也可以標記** 還可以有很多段落 [^second]: 註腳文字 ### 定義清單名詞 1 : 定義 1 快速連續項目名詞 2 加上 *行內標記* : 定義 2 { 這些程式碼屬於定義 2 的一部分 } 定義 2 的第三段落 _緊密樣式：_ 名詞 1 ~ 定義 1 名詞 2 ~ 定義 2a ~ 定義 2b ### 縮寫這是 HTML 的縮寫範例它會轉換 "HTML"，但是縮寫旁邊其他的部分，例如："xxxHTMLyyy"，不受影響 *[HTML]: Hyper Text Markup Language

Syntax	Example	Reference
# Header	Header	基本排版
- Unordered List	Unordered List
1. Ordered List	Ordered List
- [ ] Todo List	Todo List
> Blockquote	Blockquote
Bold font	Bold font
Italics font	Italics font
~~Strikethrough~~	~~Strikethrough~~
19^th^	19^th
H~2~O	H₂O
++Inserted text++	Inserted text
==Marked text==	Marked text
[link text](https:// "title")	Link
![image alt](https:// "title")	Image
`Code`	`Code`	在筆記中貼入程式碼
```javascript var i = 0; ```	`var i = 0;`
:smile:		Emoji list
{%youtube youtube_id %}	Externals
$L^aT_eX$	L^aT_eX
:::info This is a alert area. :::	This is a alert area.