zoukankan      html  css  js  c++  java
  • 用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文件选项卡
  • 相关阅读:
    Python基础-面向对象1
    Centos升级安装.Net core 1.1
    员工大规模离职事件的处理方法和启示
    React Redux学习笔记
    Tfs 2015 代理池配置笔记
    自动化测试UI Test, Performance Test, Load Test 总结整理
    [转]【长文干货】浅析分布式系统
    .Net身份验证概述
    Owin中间件搭建OAuth2.0认证授权服务体会
    使用Owin中间件搭建OAuth2.0认证授权服务器
  • 原文地址:https://www.cnblogs.com/EdisonVan/p/10448253.html
Copyright © 2011-2022 走看看