markdown的快速入门干货和技巧

1. markdown入门

markdown入门其实很简单，以前我很喜欢用有富文本编辑的编辑器来记录东西，总觉得像Word一样修改格式很方便。但是这样写出来的文章或者笔记有个很致命的问题，就是如果将笔记粘贴到另一个平台或者软件时，很容易出现格式的扭曲，字体的不对称等问题。

相反，markdown文件在很多平台（CSDN、简书、博客园等等）都得到支持，可以像Java字节码文件一样在不同平台上使用。只需要不超过一个小时的时间，就能舒舒服服的踏进md的圈子，就像用机械键盘一样，再也不想去用富文本编辑器了。

网上有太多的md语法介绍，如果通篇去阅读毫无意义。所以比较好的办法就是直接实战入手，有个不错的在线编辑网站（阅读原文可跳转：https://www.zybuluo.com/mdeditor），主页提供了绝大多数md的格式写法，只要略加修改就能把自己的文档md化。另外，有道云笔记、CSDN、简书或者马克飞象等，都可以直接拿来，边写边熟悉语法，一个小时很容易就上手了。

2. markdown的一些使用技巧

2.1 如何定义页内跳转：

在被跳转的地方使用：<span id="锚点的名称">被跳转的文字</span>，然后在锚点处这样使用：[要高亮显示的文字](#锚点的名称)

示例：

跳到这里啦;

我要跳转到标题1;

span标签可以换成div，效果只是后边的文字是否会换行

微信公众号不支持这种跳转（欢迎阅读原文尝试效果）

2.2 如何生成目录树：

markdown可以自动生成目录树，只需要在需要插入目录树的地方写入"[TOC]"( 要单独占一行)，这样会自动生成目录树，并且目录树可以点击跳转到对应的标题

截止19年5月，微信公众号和某书还是不支持toc语法。。。

2.3 如何将md文件放到微信公众号中：

笔者尝试过网上很多方法，或者过时，或者格式错乱。所以目前笔者选择的方法是将md文件用有道云笔记打开，然后到处成html文件，然后将html的源码复制到微信公众号的编辑栏中（如果没有代码可以直接复制富文本；如果有代码的情况，笔者出现代码行皆消失的情况，需要赋值html源码）。最后查看微信公众号的排版，略加修改即可。

2.4 项目目录文件结构的展示

用mddir来生成项目目录结构(查看原文可跳转)

效果如下：

|-- Desktop
    |-- .DS_Store
    |-- .gitignore
    |-- README.md
    |-- index.html
    |-- ai
    |-- always
    |   |-- .DS_Store
    |   |-- swoole_thread.jpg
    |-- backend
        |-- .DS_Store
        |-- jetbrains.jpg
        |-- swoole.jpeg
        |-- swoole_run.png

超级简单实用，官网说明：

To install: npm install mddir -g
To generate markdown for current directory: mddir
To generate for any absolute path: mddir /absolute/path
To generate for a relative path: mddir ~/Documents/whatever.
The md file gets generated in your working directory.
Currently ignores node_modules, and .git folders.