用markdown開始優雅的寫作



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文件夾!
Atom-Packages位置-20190510

Step1.打開Atom插件官網,找到自己需要安裝的插件介紹頁面,點擊Versions到自己要下載的版本復制github鏈接
插件Link-20190611

Step2.在Atom對應的packages文件夾下打開終端
PackageUrl-20190611

Step3.以下載pretty-json為例

  • git clone pretty-json對應的git倉庫地址
  • cd atom-Beautify (進入pretty-json插件所在文件夾)
  • yarn/cnpm install (部署安裝插件的依賴庫,推薦使用yarn)
    InstallMethod-20190611
    Step4.最后重啟Atom,插件安裝完成

1.預覽插件markdown-preview-enhanced(預覽)[宇宙無敵最強]
功能簡介:可以制作流程圖和幻燈片,以及拖動圖片上傳,拖動的圖片上傳的地址是https://i.imgur.com,不放心的就要經常做好備份了。本地留一個備份,寫完以后可以直接導出成html,pdf,md文件,以及生成長圖,等等。
Preview-20190611

2.同步滾動(markdown-scroll-sync)
Scroll-20190611

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>

5.git動圖插入插件

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文件夾下子文件預覽
目錄-20190611

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文件選項卡


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM