1. 安装atom
- 由于自己早就安装好了,这里也不好记录详细的安装教程,为大家提供一个比较完整的参考教程:
ubuntu18.04如何安装Atom - 注意: 打开atom的官网非常慢,我们可以通过github下载,我下载的是1.36.0的atom-amd64.deb。
2. 新建自己的markdown文件
- 在菜单栏中点击
File --> New File
,输入以下内容后,ctrl+s
保存为markdown文件,文件命名1.md。
#### 这是我的第一个markdown文件
hello world
- 通过快捷键
ctrl+shift+M
,预览自己编辑的markdown文件,或者菜单栏Packages --> Markdown to Preview --> Toggle Preview
,实现markdown文件的实时预览。
3. 安装相关插件
① 打开atom的settings
- 方法一: 我们如果只想打开Packages,进行插件安装的话,可以从atom启动后的Welcome Guide中打开,点击Install a Package即可。
- 方法二: 菜单栏
Packages --> Settings View --> Open
,我们主要会用到左边栏的Packages
和Install
。其中Packages可以查看已经安装的插件,实现对插件的管理
(Uninstall
、Disable禁用
、Enable启用
);Install可以输入关键词,查询自己想要安装的插件
。
② 安装markdown-preview-plus(如果想要实时滚动起作用,可以跳过该插件)
- atom中已经默认安装了markdown-preview,我们刚刚在预览markdown文件时,已经使用到了。
- markdown-preview-plus相对于默认的markdown-preview,他多了对Latex公式的支持(ctrl+shift+X)。
- 在Install的搜索框中输入markdown-preview-plus,点击Install进行安装。我这里是已经安装过了(于是从Packages中进行的搜索),但为了使用实时滚动,所以又禁用了。
- markdown-preview-plus使用之前,需要先禁用markdown-preview。
- 禁用插件的方法:Packages中输入markdown-preview,点击Disable让其变成上图中的样子即可。
③ 安装markdown-scroll-sync(同步滚动)
markdown-scroll-sync
不仅支持同步滚动,在光标位置发生变更时也会同步滚动,这个功能在很多Markdown编辑器中不具备。- 注意: 要想使用同步滚动功能,一定不能使用
markdown-preview-plus
。因为这个插件是针对原生的markdown-preview
的,如果你装了markdown-preview-plus
是没用的。 - 我自己就遇到了这个情况,找了很久才找到原因。必须要感谢知乎:atom中markdown-scroll-sync为什么不能同步预览?
- 安装方法跟markdown-preview-plus一样,输入的关键词为markdown-scroll-sync。
- 安装后,markdown文件发生滚动,右边的预览文件也会发生滚动,超级方便!!!
④ 安装language-markdown(代码增强)
- 一般的Markdown编辑器提供了代码着色等基本功能,
language-markdown
除了能给代码着色,还提供了快捷的代码片段生成等功能。 - 他可以自动帮助我们进行代码生成,比如我想编辑一个java 的class,当我们
输入cl
时,就会提示class
,然后帮我们生成以下内容:
class MyClass extends Parent implements Interface {
}
- 我们便可以按照自己的意愿,进行代码的编辑了。
⑤ 安装markdown-image-assistant(图片助手)
- 也有教程说安装
markdown-image-paste
,但是我安装以后,重启了atom,将截图保存在剪贴板中后,ctrl+v
没有任何反应。感兴趣的可以尝试一下:使用Atom快速打造好用的Markdown编辑器 - 安装好
markdown-image-assistant
后,将截图保存在剪贴板中,然后ctrl+v
生成对应的代码,并在预览中显示对应的图片。可以在[]
中为图片命名,我的命名为icon。
![icon](assets/1-93d1b9bf.png)
⑥ 安装markdown-table-editor(表格编辑)
- markdown中编辑表格时,要么粘贴表格样式,要么手动输入相关代码,非常麻烦!
- 使用
markdown-table-editor
,输入表头姓名
后,按Tab键
,自动帮我们补全表格;写好表头后,在第二行末尾按enter键
,自动帮我们生成表格。 - PS: 由于自己不会添加动图,所以无法展示
markdown-table-editor
的强大功能。这款插件超级推荐!!!
⑦ 安装markdown-pdf(markdown文件导出为pdf)
- 安装完成后,使用
快捷键ctrl+shift+c
,便可以将markdown文件导出为pdf文件。
- 如果导出pdf时
出现错误提示
,或者发现生成的内容空白、有误
,可以查看console了错误原因。 - 菜单栏
View --> Developer --> Developer Tools
,打开开发者工具,然后选择console查看错误原因。
markdown-pdf.js? [sm]:135 Error:
ENOENT: no such file or directory, open '/home/hadoop/.atom/styles.less'
- 解决办法: 参考博客 Markdown导出PDF(Atom编辑器的插件markdown-pdf)。
- 自己的错误虽然与其不一样,但是通过博客中的方法也解决了自己的问题,超级感谢!
⑧ 安装pdf-view
- 安装了markdown-pdf插件,发现通过atom查看pdf文档为乱码。这时需要安装pdf-view插件即可!