文章目录

 

1. markdown入门

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

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

网上有太多的md语法介绍,如果通篇去阅读毫无意义。所以比较好的办法就是直接实战入手,有个不错的在线编辑网站,主页提供了绝大多数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的源码复制到微信公众号的编辑栏中(如果直接复制富文本,笔者出现代码行皆消失的情况)。最后查看微信公众号的排版,略加修改即可。

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

2019.5.13更新

用mddir来生成项目目录结构: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.

一点感悟:

直到最近开了微信公众号,我才发现公众号里的文章都是不分章节的,更像是过程式编程,从头到尾一条主线。原因我认为就是公众号文章还没有博客这样支持目录跳转等丰富的结构。而相对来说,博客就可以自由得多,也强大得多(然而我的文章风格还是更适合博客/(ㄒoㄒ)/~~)。

markdown的快速入门干货(持续更新,欢迎收藏)_目录树