true
,强制下载Font Awesome (用于图标),如果设置为 false
,阻止下载,默认值为 undefined
,这将智能检查字体是否已经包括Font Awesome,然后进行相应操作。true
,将自动聚焦编辑器,默认值为 false
。true
将自动保存输入的文本,默认值为 false
。10000
(10s)。**
或 __
,默认值为 **
。```
或 ~~~
,默认值为 ```
。*
或 _
,默认值为 *
。true
,在SimpleMDE中改变文本将立即同步至原textarea元素,默认值为 false
。false
,用空格代替制表符缩进,默认值为 true
。['[', '](http://)']
。
false
,禁用自动换行,默认值为 true
。true
将不渲染#
后的空格,默认值为 false
。false
将不对GFM语法进行解析,默认值为 true
。true
将使用下划线作为分隔符,默认值为 false
。true
将出现一个JS警告窗口来获取链接或图片的网址,默认值为 false
。false
将禁用解析GFM换行符,默认值为 true
。true
,将使用highlight.js进行高亮显示,默认值为 false
。要使用这个功能,你必须在你的网页中引入highlight.js。 原版需像下面这样手动引入,本插件已集成highlight.js无需再次引入。<script src='https://cdn.jsdelivr.net/highlight.js/latest/highlight.min.js'></script>
<link rel='stylesheet' href='https://cdn.jsdelivr.net/highlight.js/latest/styles/github.min.css'>
false
将禁用拼写检查,默认值为 true
。false
,隐藏状态栏。默认值为包含内置状态栏项目的数组。
false
将移除被选择文本的CodeMirror-selectedtext
类,默认值为 true
。2
。false
将隐藏工具栏,默认值为图标数组。false
将不显示工具栏提示,默认值为 true
。// 以下大多数选项为非默认行为
export default {
data () {
return {
configs: {
autofocus: true,
autosave: {
enabled: true,
uniqueId: 'MyUniqueID',
delay: 1000
},
blockStyles: {
bold: '__',
italic: '_'
},
element: document.getElementById('MyID'),
forceSync: true,
hideIcons: ['guide', 'heading'],
indentWithTabs: false,
initialValue: 'Hello world!',
insertTexts: {
horizontalRule: ['', '\n\n-----\n\n'],
image: ['![](http://', ')'],
link: ['[', '](http://)'],
table: ['', '\n\n| Column 1 | Column 2 | Column 3 |\n| -------- | -------- | -------- |\n| Text | Text | Text |\n\n']
},
lineWrapping: false,
parsingConfig: {
allowAtxHeaderWithoutSpace: true,
strikethrough: false,
underscoresBreakWords: true
},
placeholder: 'Type here...',
previewRender: function(plainText) {
return customMarkdownParser(plainText) // 返回HTML自定义解析器
},
previewRender: function(plainText, preview) { // 异步方法
setTimeout(function () {
preview.innerHTML = customMarkdownParser(plainText)
}, 250)
return '加载中...'
},
promptURLs: true,
renderingConfig: {
singleLineBreaks: false,
codeSyntaxHighlighting: true
},
shortcuts: {
drawTable: 'Cmd-Alt-T'
},
showIcons: ['code', 'table'],
spellChecker: false,
status: false,
status: ['autosave', 'lines', 'words', 'cursor'], // Optional usage
status: ['autosave', 'lines', 'words', 'cursor', {
className: 'keystrokes',
defaultValue: function(el) {
this.keystrokes = 0
el.innerHTML = '0 Keystrokes'
},
onUpdate: function(el) {
el.innerHTML = ++this.keystrokes + ' Keystrokes'
}
}], // Another optional usage, with a custom status bar item that counts keystrokes
styleSelectedText: false,
tabSize: 4,
toolbar: false,
toolbarTips: false
}
}
}
}
下面是内置的工具栏图标(只有一些默认启用),你可以根据喜好重新排列。如果按钮有快捷键,将自动显示提示(即如果把action
设置为toggleBold
,title
设置加粗
,最终的提示文本将为加粗(Ctrl-B)
)。
此外,你可以在工具栏数组中任意两个图标之间添加一个分离线'|'
。
name | action | title className |
---|---|---|
bold | toggleBold | 加粗 fa fa-bold |
italic | toggleItalic | 斜体 fa fa-italic |
strikethrough | toggleStrikethrough | 删除线 fa fa-strikethrough |
heading | toggleHeadingSmaller | 标题 fa fa-header |
heading-smaller | toggleHeadingSmaller | 缩小标题 fa fa-header |
heading-bigger | toggleHeadingBigger | 增大标题 fa fa-lg fa-header |
heading-1 | toggleHeading1 | 大标题 fa fa-header fa-header-x fa-header-1 |
heading-2 | toggleHeading2 | 中等标题 fa fa-header fa-header-x fa-header-2 |
heading-3 | toggleHeading3 | 小标题 fa fa-header fa-header-x fa-header-3 |
code | toggleCodeBlock | 代码块 fa fa-code |
quote | toggleBlockquote | 引用 fa fa-quote-left |
unordered-list | toggleUnorderedList | 无序列表 fa fa-list-ul |
ordered-list | toggleOrderedList | 有序列表 fa fa-list-ol |
clean-block | cleanBlock | 清除格式 fa fa-eraser fa-clean-block |
link | drawLink | 插入链接 fa fa-link |
image | drawImage | 插入图片 fa fa-picture-o |
table | drawTable | 插入表格 fa fa-table |
horizontal-rule | drawHorizontalRule | 插入水平线 fa fa-minus |
preview | togglePreview | 预览 fa fa-eye no-disable |
side-by-side | toggleSideBySide | 全屏预览 fa fa-columns no-disable no-mobile |
fullscreen | toggleFullScreen | 全屏 fa fa-arrows-alt no-disable no-mobile |
guide | 跳转链接 | Markdown引导 fa fa-question-circle |
使用toolbar
选项自定义工具栏:
// 仅自定义现有按钮的顺序
export default {
data () {
return {
configs: {
toolbar: ['bold', 'italic', 'heading', '|', 'quote']
}
}
}
}
// 自定义所有信息和/或添加你的图标
export default {
data () {
return {
configs: {
toolbar: [{
name: 'bold',
action: SimpleMDE.toggleBold,
className: 'fa fa-bold',
title: '加粗'
},
{
name: 'custom',
action: function customFunction (editor) {
// 添加你的代码
},
className: 'fa fa-star',
title: '自定义按钮'
},
'|' // 分隔符
...
]
}
}
}
}
SimpleMDE带有预定义键盘快捷键的数组,可以用一个配置选项改变。默认的列表如下:
快捷键 | 操作 |
---|---|
Cmd-‘ | ‘引用’ |
Cmd-B | ‘加粗’ |
Cmd-E | ‘清除格式’ |
Cmd-H | ‘缩小标题’ |
Cmd-I | ‘斜体’ |
Cmd-K | ‘插入链接’ |
Cmd-L | ‘插入无序列表’ |
Cmd-P | ‘预览’ |
Cmd-Alt-C | ‘插入代码块’ |
Cmd-Alt-I | ‘插入图片’ |
Cmd-Alt-L | ‘插入有序列表’ |
Shift-Cmd-H | ‘增大标题’ |
F9 | ‘全屏预览’ |
F11 | ‘全屏’ |
可以只修改部分快捷键,其他保持不变:
export default {
data () {
return {
configs: {
shortcuts: {
'toggleOrderedList': 'Ctrl-Alt-K', // 改变插入有序列表的快捷
'toggleCodeBlock': null, // 不绑定插入代码块的快捷键
'drawTable': 'Cmd-Alt-T' // 绑定没有预设快捷键的操作,插入表格
}
}
}
}
}
快捷键会在平台之间自动转换。如果你定义一个快捷键为“Cmd-B”,在PC机上的快捷键将更改为“Ctrl-B”。反之亦然。
可以绑定的操作列表与工具栏按钮的内置操作列表相同。
改变最小高度:
.markdown-editor .CodeMirror, .markdown-editor .CodeMirror-scroll {
min-height: 200px;
}
设置高度为一个固定值:
.markdown-editor .CodeMirror {
height: 300px;
}