[洛穀日報#204] StackEdit——Markdown 編輯器的功能介紹
本文同時發表於洛穀日報，您也可以通過洛谷部落格進行查看。
1.介紹與開始使用
1.1 這是什麼？
StackEdit是基於PageDown、Stack Overflow和其他堆棧交換站點使用的Markdown庫的功能齊全的開源Markdown編輯器。它可以在離線時使用，並可以把數據(md文件)存儲到瀏覽器上，還可以綁定CouchDB、GitHub、GitLab、Google Drive等工作空間。它還可以任意創建文件夾，並且可以任意創建文件。被刪除的文件還會保留在Trash文件夾里。
1.2 開始使用 StackEdit
要開始使用，可以直接訪問StackEdit的編輯器://stackedit.io/app# ，接著進去就是一些歡迎文件。你也可以訪問Chrome網上應用店，來下載他的離線擴展程式。離線擴展程式只能使用離線功能。
你也可以下載其Chrome應用。所謂Chrome應用，即基於網頁的應用，也就是說進入應用會打開一個網頁，只不過是多了一個窗口，其實跟正常的網頁大同小異。
上方是筆者用的Mac的Chrome程式
//chrome.google.com/webstore/detail/iiooodelglhkcpgbajoejffhijaclcdg
2.功能介紹
2.1 頂欄功能
頂欄上的工具與功能有：撤回、重做、創建加粗文本、創建傾斜文本、創建標題文本、創建劃線文本、創建無序列表、創建有序列表、創建引用文本、創建程式碼框、創建表格、創建超鏈接、創建圖片。
點擊左邊的文件夾圖標，進入資源管理器，可以看到資源管理器的頂欄，可以創建文件夾，創建Markdown文件。而刪除文件之後，文件自動放到Trash文件夾中。Trash文件夾中的文件會保留七天，然後自動刪除。你可以右鍵文件或文件夾，來重命名或刪除。也可以選中需要刪除或重命名的文件，然後點擊上面的圖標來操作。頂欄的右側的同步圖標只在你綁定了Google帳號或其他的時候才有用。它可以強制同步或停止同步。上傳按鈕可以把本地的文件上傳至你綁定的GitHub等網站。右邊的logo可以打開一個側欄。你可以用Google帳號登錄、綁定你的工作空間、同步文件、上傳、查看以前的更改記錄，還可以把md文件直接上傳至WordPress等部落格網站、Markdown元素大全、導入或導出、或列印你的md文件。還有成就（探索StackEdit的功能可以得到成就）模版和綁定帳號。更有備份工作空間和重置應用等功能。你還可以在頂欄文件名雙擊來重命名你現在正在編輯的文件。
2.2 編輯器功能
你可以點擊右面預覽窗口的眼睛符號來全螢幕預覽，點擊兩個並排的方塊來全螢幕編輯，點擊最上的按鈕來收起頂欄。如你在全螢幕預覽模式下，你可以點擊右上角的「筆」來返回編輯。
2.3 綁定帳號
你可以進入菜單中的Accounts來綁定帳號。
2.3.1 github 綁定方法
進入accounts後，點擊綁定github帳號，如果你想讓stackedit來訪問你的私有倉庫，請選中它。
然後你需要授權StackEdit來訪問你的項目。benweet是這個編輯器的開發者。授權需要 sudo 許可權。
確認密碼後，就會回到StackEdit,你會看到你的帳號被綁定了。
2.3.2 wordpress 綁定方法
它會提示你要登陸賬戶。登陸後，會提示你確認。點擊批准。
綁定成功！
綁定成功後就可以綁定項目了！
2.4 個性化
你可以通過菜單中的Settings來訪問個性化設置，以下是程式碼的中文翻譯。
# 設置編輯器模式，light 或 dark
colorTheme: light
# 調節在編輯器和預覽中的字體大小
fontSizeFactor: 1
# 在編輯器和預覽中調整最大文本寬度
maxWidthFactor: 1
# 自動同步頻率（MS）。最低為60000。
autoSyncEvery: 90000
# 編輯器設置
editor:
# 自動列表編號
listAutoNumber: true
# 在編輯器中顯示影像
inlineImages: true
# 只使用等線字體
monospacedFontOnly: false
# 鍵盤快捷鍵
# 見//craig.is/killing/mice
shortcuts:
mod+s: sync
mod+f: find
mod+alt+f: replace
mod+g: replace
mod+shift+b: bold
mod+shift+c: clist
mod+shift+k: code
mod+shift+h: heading
mod+shift+r: hr
mod+shift+g: image
mod+shift+i: italic
mod+shift+l: link
mod+shift+o: olist
mod+shift+q: quote
mod+shift+s: strikethrough
mod+shift+t: table
mod+shift+u: ulist
'= = > space':
method: expand
params:
- '==> '
- '⇒ '
'< = = space':
method: expand
params:
- '<== '
- '⇐ '
# 選項傳遞給html to pdf
# 見//wkhtmltopdf.org/usage/wkhtmltopdf.txt
wkhtmltopdf:
marginTop: 25
marginRight: 25
marginBottom: 25
marginLeft: 25
# A3, A4, Legal 或者 Letter
pageSize: A4
# 選項傳遞給pandoc
# 見 //pandoc.org/MANUAL.html
pandoc:
highlightStyle: kate
toc: true
tocDepth: 3
# HTML to Markdown 轉換器選項
# 見 //github.com/domchristie/turndown
turndown:
headingStyle: atx
hr: ----------
bulletListMarker: '-'
codeBlockStyle: fenced
fence: '```'
emDelimiter: _
strongDelimiter: '**'
linkStyle: inlined
linkReferenceStyle: full
# GitHub/GitLab 更改說明
git:
createFileMessage: '{{path}} created from //stackedit.io/'
updateFileMessage: '{{path}} updated from //stackedit.io/'
deleteFileMessage: '{{path}} deleted from //stackedit.io/'
# 新文件的默認內容
newFileContent: |
# 此處 可以任意設置，為md程式碼
> Written with [StackEdit](//stackedit.io/).
# 新文件的默認屬性
newFileProperties: |
# 擴展程式：
# preset: gfm
2.5 成就
你可以探索功能來解鎖成就（共93個）。你也可以進入邊欄的badges，來查看怎麼解鎖成就。祝你探險愉快！
2.6 標題列表
便欄中的Table Of Contents 可以告訴你文章的結構。
2.7 導入或導出
你可以在邊欄中找到Import/Export，看到這一些導入導出模式。有導入Markdown和導入HTML(自動轉換為md文件)，也可以導出md文件或轉換為HTML導出。但是下面的導出為PDF和更多的如Word文檔，是收費的。你需要贊助$5（約34.3765人民幣）。贊助入口在你打開窗口的之後上面有一個紅條，點擊進入來贊助。（偷偷說一句，用html下載後可以找一些在線轉換網站轉換，逃～）
2.8 上傳至部落格
點擊邊欄中的Publish，如你已經綁定帳號和項目，你可以直接上傳md文件。如你還沒有，請參照2.3中的內容綁定。
2.9 列印
點擊邊欄中的Print，來進入列印設置與預覽介面。
2.10 重置StackEdit
在邊欄中的Reset Application 來重置。重置後會刪除你在瀏覽器中離線保存的（沒有上傳到網上的，已經上傳的不受影響）文件，所以請慎重考慮。
3.遇到問題？
你可以在StackEdit的官方社區//community.stackedit.io/尋求幫助，但是記住，盡量用英語哦！文檔等資訊在//community.stackedit.io/c/how-to中。
Written with StackEdit.
