[洛谷日报#204] StackEdit——Markdown 编辑器的功能介绍

本文同时发表于洛谷日报，您也可以通过洛谷博客进行查看。

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应用，即基于网页的应用，也就是说进入应用会打开一个网页，只不过是多了一个窗口，其实跟正常的网页大同小异。



上方是笔者用的Mac的Chrome程序

https://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  

# 键盘快捷键
# 见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 成就

你可以探索功能来解锁成就（共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的官方社区https://community.stackedit.io/寻求帮助，但是记住，尽量用英语哦！文档等信息在https://community.stackedit.io/c/how-to中。

Written with StackEdit.