StackEdit——Markdown 编辑器的功能介绍

![logo](https://s2.ax1x.com/2019/07/16/Z73lfx.png)
### 1.介绍与开始使用
#### 1.1 这是什么？
StackEdit是基于PageDown、Stack Overflow和其他堆栈交换站点使用的Markdown库的**功能齐全**的开源Markdown编辑器。它可以**在离线时使用**，并可以**把数据(md文件)存储到浏览器上**，还可以绑定CouchDB、GitHub、GitLab、Google Drive等工作空间。它还可以任意创建文件夹，并且可以任意创建文件。被删除的文件还会保留在Trash文件夹里。
#### 1.2 开始使用 StackEdit
要开始使用，可以直接访问StackEdit的编辑器:https://stackedit.io/app# ，接着进去就是一些欢迎文件。你也可以访问Chrome网上应用店，来下载他的离线扩展程序。离线扩展程序只能使用离线功能。  
你也可以下载其Chrome应用。所谓Chrome应用，即基于网页的应用，也就是说进入应用会打开一个网页，只不过是多了一个窗口，其实跟正常的网页大同小异。
![ZqGQu6.png](https://s2.ax1x.com/2019/07/17/ZqGQu6.png)
上方是笔者用的Mac的Chrome程序  
[https://chrome.google.com/webstore/detail/iiooodelglhkcpgbajoejffhijaclcdg](https://chrome.google.com/webstore/detail/iiooodelglhkcpgbajoejffhijaclcdg)
### 2.功能介绍
#### 2.1 顶栏功能
![](https://s2.ax1x.com/2019/07/16/Z73cng.png)
顶栏上的工具与功能有：撤回、重做、创建加粗文本、创建倾斜文本、创建标题文本、创建划线文本、创建无序列表、创建有序列表、创建引用文本、创建代码框、创建表格、创建超链接、创建图片。  
点击左边的文件夹图标，进入资源管理器，可以看到资源管理器的顶栏，可以创建文件夹，创建Markdown文件。而删除文件之后，文件自动放到Trash文件夹中。Trash文件夹中的文件会保留七天，然后自动删除。你可以右键文件或文件夹，来重命名或删除。也可以选中需要删除或重命名的文件，然后点击上面的图标来操作。顶栏的右侧的同步图标只在你绑定了Google账号或其他的时候才有用。它可以强制同步或停止同步。上传按钮可以把本地的文件上传至你绑定的GitHub等网站。右边的logo可以打开一个侧栏。你可以用Google账号登录、绑定你的工作空间、同步文件、上传、查看以前的更改记录，还可以把md文件直接上传至WordPress等博客网站、Markdown元素大全、导入或导出、或打印你的md文件。还有成就（探索StackEdit的功能可以得到成就）模版和绑定账号。更有备份工作空间和重置应用等功能。你还可以在顶栏文件名双击来重命名你现在正在编辑的文件。
#### 2.2 编辑器功能
你可以点击右面预览窗口的眼睛符号来全屏预览，点击两个并排的方块来全屏编辑，点击最上的按钮来收起顶栏。如你在全屏预览模式下，你可以点击右上角的“笔”来返回编辑。
#### 2.3 绑定账号
![ZqGmC9.png](https://s2.ax1x.com/2019/07/17/ZqGmC9.png)

你可以进入菜单中的Accounts来绑定账号。

##### 2.3.1 github 绑定方法
![ZqG9cq.png](https://s2.ax1x.com/2019/07/17/ZqG9cq.png)

进入accounts后，点击绑定github账号，如果你想让stackedit来访问你的私有仓库，请选中它。

![ZqGEEF.png](https://s2.ax1x.com/2019/07/17/ZqGEEF.png)

然后你需要授权StackEdit来访问你的项目。benweet是这个编辑器的开发者。授权需要 sudo 权限。

![ZqGiuV.png](https://s2.ax1x.com/2019/07/17/ZqGiuV.png)
![ZqGCj0.png](https://s2.ax1x.com/2019/07/17/ZqGCj0.png)

确认密码后，就会回到StackEdit,你会看到你的账号被绑定了。

##### 2.3.2 wordpress 绑定方法
![ZqGVN4.png](https://s2.ax1x.com/2019/07/17/ZqGVN4.png)

它会提示你要登陆账户。登陆后，会提示你确认。点击批准。

![ZqGZ4J.png](https://s2.ax1x.com/2019/07/17/ZqGZ4J.png)

绑定成功！

![ZqGFBT.png](https://s2.ax1x.com/2019/07/17/ZqGFBT.png)
![ZqGKjx.png](https://s2.ax1x.com/2019/07/17/ZqGKjx.png)

绑定成功后就可以绑定项目了！
#### 2.4 个性化
你可以通过菜单中的Settings来访问个性化设置，以下是代码的中文翻译。
```yaml
# 设置编辑器模式，light 或 dark  
colorTheme: light  
# 调节在编辑器和预览中的字体大小  
fontSizeFactor:  1  
# 在编辑器和预览中调整最大文本宽度
maxWidthFactor:  1  
# 自动同步频率（MS）。最低为60000。
autoSyncEvery:  90000  
  
# 编辑器设置 
editor:  
# 自动列表编号  
listAutoNumber:  true  
# 在编辑器中显示图像
inlineImages:  true  
# 只使用等线字体  
monospacedFontOnly:  false  
  
# 键盘快捷键  
# 见https://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
# 见https://wkhtmltopdf.org/usage/wkhtmltopdf.txt 
wkhtmltopdf:  
marginTop:  25  
marginRight:  25  
marginBottom:  25  
marginLeft:  25  
# A3, A4, Legal 或者 Letter  
pageSize: A4  
  
# 选项传递给pandoc
# 见 https://pandoc.org/MANUAL.html  
pandoc:  
highlightStyle: kate  
toc:  true  
tocDepth:  3  
  
# HTML to Markdown 转换器选项  
# 见 https://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 https://stackedit.io/'  
updateFileMessage:  '{{path}} updated from https://stackedit.io/'  
deleteFileMessage:  '{{path}} deleted from https://stackedit.io/'  
  
# 新文件的默认内容
newFileContent:  |  
  
  
# 此处 可以任意设置，为md代码
> Written with [StackEdit](https://stackedit.io/).  
  
# 新文件的默认属性
newFileProperties:  |  
# 扩展程序： 
# preset: gfm
```
#### 2.5 成就
![ZqGug1.png](https://s2.ax1x.com/2019/07/17/ZqGug1.png)

你可以探索功能来解锁成就（共93个）。你也可以进入边栏的badges，来查看怎么解锁成就。祝你探险愉快！
#### 2.6 标题列表
![ZqGkHU.png](https://s2.ax1x.com/2019/07/17/ZqGkHU.png)

便栏中的Table Of Contents 可以告诉你文章的结构。
#### 2.7 导入或导出
![ZqGn3R.png](https://s2.ax1x.com/2019/07/17/ZqGn3R.png)

你可以在边栏中找到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的官方社区[https://community.stackedit.io/](https://community.stackedit.io/)寻求帮助，但是记住，尽量用英语哦！文档等信息在[https://community.stackedit.io/c/how-to](https://community.stackedit.io/c/how-to)中。
> Written with [StackEdit](https://stackedit.io/).

正在渲染内容...