ebook:
title: Atom編寫markdown
authors: EdisonVan
前言
markdown可以用來干嘛?
- 項目需求分析
- 開發項目收獲記載
- 技術書籍閱讀筆記
- 給心愛的姑娘寫信
- 社交平台寫作:GitHub、微信公眾號、知乎、博客園、語雀、掘金等眾多平台支持markdown
學習markdown(記少不記多的原則)
獻上我的markdown筆記(相信我看着一個就足以應付日常使用了,整理於markdown官方文檔和個人實踐!)
推薦工具
推薦使用Atom,為什么不用VsCode?因為vscode裝太多插件可能導致各種快捷鍵沖突,所以強力推薦Atom專職書寫markdown!
目錄
單文件中章節跳轉寫法如下:
* [章 1-Readme.md編寫規范](#Readme.md編寫規范)
* [章 2-為什么選Atom](#為什么選Atom)
* [插件下載](#插件下載)
* [章 3-常用快捷鍵](#常用快捷鍵)
Atom插件下載
高速下載方式1:
開啟全局代理,在Atom編輯器中點擊Preference-Install-搜索插件名
進行下載
高速下載方式2:
在自己的Atom的packages文件夾中打開終端通過yarn命令行進行下載!
請看准自己的Atom的packages文件夾!
Step1.打開Atom插件官網,找到自己需要安裝的插件介紹頁面,點擊Versions到自己要下載的版本復制github鏈接
Step2.在Atom對應的packages文件夾下打開終端
Step3.以下載pretty-json為例
git clone pretty-json對應的git倉庫地址
cd atom-Beautify
(進入pretty-json插件所在文件夾)yarn/cnpm install
(部署安裝插件的依賴庫,推薦使用yarn)
Step4.最后重啟Atom,插件安裝完成
1.預覽插件markdown-preview-enhanced(預覽)[宇宙無敵最強]
功能簡介:可以制作流程圖和幻燈片,以及拖動圖片上傳,拖動的圖片上傳的地址是https://i.imgur.com,不放心的就要經常做好備份了。本地留一個備份,寫完以后可以直接導出成html,pdf,md文件,以及生成長圖,等等。
- 使用該插件前,請先禁用Atom自帶的markdown-preview插件(Enable點為disabled即可)
markdown-preview-enhanced功能詳細介紹
2.同步滾動(markdown-scroll-sync)
3.代碼增強(language-markdown):代碼着色等基本功能,還提供了快捷的代碼片段生成等功能 [請在settings中看快捷鍵]
4.圖片粘貼(markdown-image-paste)一步完成一堆重復操作:截圖-命名-保存-插入。 [需要配合千牛雲等工具搭建圖床,自行拓展]
步驟1. 使用截圖工具將圖片復制到系統剪切板。
步驟2. 在Markdown新起一行輸入文件名。
步驟3. Ctrl + V 會自動把圖片保存到Markdown文件相同目錄下(因此要求Markdown文件應該先保存),並命名為剛輸入的文件名,同時在剛才輸入文件名行處生成img標簽。
- 傳統插入圖片方式
<img src="assets/Web.jpg" width=1200 height=1500>
6.Atom Beautify
格式化代碼的插件
7.markdown-assistant [待完善]
要配合uploader使用
markdown快捷圖床搭建
8.markdown-writer [待完善]
9.pretty-json(讓json變得更漂亮)
使用方式:1、選中一段json,只要選擇json的內容接口;2、使用快捷鍵 ctrl + shift + p,打開命令輸入框 輸入 pretty json prettify,按enter鍵即可看到格式化的效果;
10.markdown格式規范插件 [待查找]
11.Atom導出epub文件 [通過calibre 這個軟件]
Github參考教程
MyEbook Link :/usr/local/bin/ebook-convert
12.minimap
預覽全部代碼的一個插件,同時能方便的移動到指定的文件位置。
13.terminal-panel
用於執行命令並顯示輸出。打開終端面板快捷鍵:Ctrl + `
14.表格編輯(markdown-table-editor)
竅門:格子出來再輸入中文,每次中途切換為中文輸入法,有時導致Tab鍵無效
使用:用Tab換一格,因為使用了language-markdown插件,所以這里要用空格
用Enter換行
用ESC退出表格編輯
寫法:
| 插件 | 功能 |
| ------ | ---- |
| markdown-table-editor | 寫表格唄 |
效果:
插件 | 功能 |
---|---|
markdown-table-editor | 寫表格唄 |
15.高亮插件
atom-wxml
16.文件路徑自動提示:autocomplete-paths
17.代碼快速生成:Emmet
18.open-in-browser / open-in-browsers
右鍵左側菜單讓html在瀏覽器中打開,不用再去文件里雙擊啦~
19.javascript-snippets:
js片段代碼自動補全,就像用emmet寫html一樣 查看示例
20.file-icons:
左側樹狀圖下,根據文件類型左側顯示不同圖標
21.docblockr
智能代碼注釋,讓注釋更有規范
22.git-plus
在 Atom 里面執行 Git 命令,不用來回切換終端和編輯器
23.git-control
git面板
Atom編輯器書寫markdown注意事項
常用
-
自動保存:去擴展里搜索autosave,然后點Settings勾上enabled
Atom支持模糊查詢,輸入相關字母或者首字母即可 -
啟動自動換行
勾選設置->Editor中的 Soft Wrap即可: -
右側白線隱藏:
way1.增大設置->Editor->Preferred Line Length的值
way2.打開樣式表Atom-Stylesheet,然后在末尾添加如下幾行
atom-text-editor::shadow .wrap-guide {
//隱藏右邊的白線
visibility: hidden;
}
- 制作目錄分類管理筆記
目錄.md
* [前言](doc/preface.md)
* [作用域與閉包](doc/scope.md)
* [this全面解析](doc/this.md)
* [對象](doc/Object.md)
doc/preface.md
表示自動在目錄.md
同級位置創建一個doc文件夾,doc文件夾中會包含preface.md
文件!
doc文件夾下子文件預覽
Atom常用快捷鍵
快捷鍵 | 功能 |
---|---|
cmd + shift + p | 打開命令菜單 |
cmd + t | 模糊搜索工作目錄下的文件 |
cmt + b | 搜索已經打開的文件 |
ctrl + 0 | 焦點移動到文件目錄 |
cmd + \ | 隱藏左側目錄樹 |
ctrl + [ | 目錄中展開結點 |
ctrl + ] | 目錄中縮起結點 |
d / a / m | 對目錄選中的結點進行 刪除 / 添加 / 移動 |
cmd + f | 搜索 當前文件 |
cmd + shift + f | 搜索 目錄 |
cmd + shift + r | 搜索 tag 前提是安裝ctags (brew install ctags)且生成tags (ctags -R src/) |
alt + cmd + [ | 收起 所在代碼塊 |
alt + cmd + ] | 展開 所在代碼塊 |
alt + cmd + shift + [ | 收起 當前所有代碼塊 |
alt + cmd + shift + ] | 展開 當前所有代碼塊 |
cmd + , | settings |
cmd + k ... 方向鍵(上、下) | 切分面板 |
cmd + w | 關閉當前工作面板 |
alt + cmd + 左右 | 切換tab文件選項卡 |