Markdown 基本语法

Markdown 基本语法

markdown 简介

markdown是一款轻量级的标记语言，易读易写。主要灵感来自纯文本电子邮件格式，因此即使直接以纯文本发布也可以较好的阅读，修改和编辑。相比于HTML，markdown的符号标记更简介，数量也更少，其语法种类可以满足基本的适用于网络的书写需求。而且markdown可以兼容HTML而无需过多的说明，因此对于需要有格式要求且不需要太复杂排版的场合，如代码的readme文档，很多都是.md文件，即markdown格式编辑。

Markdown 编辑器

本机系统为 ubuntu16.04 ， 使用 Remarkable ( 安装文件 remarkable_1.87_all.deb ），Remarkable 的界面如图所示：

Markdown 常用语法

• 标题
  markdown 中用 # 来表示标题的级别，从 # 到 ###### 分别代表1级标题至6级标题。如下所示：

  

• 有序表列

  有序表列直接写数字加点就可以：

  1. 我是有序表列
  2. 我也是有序表列
  3. 我还是有序表列

• 无序表列

  • 我是无序表列
  • 我也是无序表列
  • 我还是无序表列
  • 咦？我们为啥是空心圈？应该是因为我们嵌套在“表列”这个无序表格里面的原因吧？

• 字体
  字体加粗需要用一边两个*把需要加粗的内容包括起来，即 **这里时我要加粗的文字**，效果为：
  这里是我要加粗的文字。
  斜体需要用一边一个*括起来，即 *我是斜体字*，效果为：
  我是斜体字。
  删除线用两个波浪线 ~ ，即这样 ’ 我被删除了TAT `

• 引用
  用 “>” 表示引用（后面和内容要空格），多个 “>” 可以嵌套引用，试一试

  卧槽我被引用了？

  我也引用下别人

  雾草666，引用中的引用中的引用

• 代码
  如果你是一个可怜的码农，那么：
  每一行前面打四个空格或者一个TAB键即为标记代码段落，或者使用三个“ ` ”也可以形成代码块，代码区域的内容原样输出：

import pywt
import numpy as np

def wavelet_trans( data, wavelet='db2' ):
    if (len(data.shape) == 2):
        data = data.reshape([1, data.shape[0], data.shape[1]])
    elif (len(data.shape) == 4):
        data = data[:,:,:,0]
    assert len(data.shape) == 3
    nb_img = data.shape[0]
    wavelet_stack = np.zeros([nb_img, pywt.dwt2(data[0],\
        wavelet)[0].shape[0], pywt.dwt2\
        (data[0],wavelet)[0].shape[1], 4])
    for idx in range(nb_img):
        tmp_img = data[idx]
        (cA, ( cH, cV, cD)) = pywt.dwt2( tmp_img, wavelet )
        cA = cA.reshape([cA.shape[0], cA.shape[1], 1])
        cH = cH.reshape([cH.shape[0], cH.shape[1], 1])
        cV = cV.reshape([cV.shape[0], cV.shape[1], 1])
        cD = cD.reshape([cD.shape[0], cD.shape[1], 1])
        wavelet_stack[idx] = np.concatenate( (cA,cH,cV,cD), axis = 2 )
    return wavelet_stack

• 图片
  普通的插入图片用： ![图片描述](/path/to/img.jpg "Optional title") 来完成。
  参考式的插入方法：![图片描述][id] ， 然后在对 id 指定超链接和 Optional titile：
  [id]: url/to/image "Optional title attribute" 即可。

• 超链接
  插入超链接的方法：
  [Remarkable](https://remarkableapp.github.io/linux/download.html) 方括号内为显示的文字，圆括号内为链接url，上面这个超链接即文章开头下载Remarkable的超链接，显示效果可以在前面看到。

• 表格
  如下所示，写好之后与上面空一行，即可以看到表格

  Name	Academy	score
  Harry Potter	Gryffindor	90
  Hermione Granger	Gryffindor	100
  Draco Malfoy	Slytherin	90

其中第二行可以用来指定对其方式“-”为默认左对齐，“:-:” 为居中，“-:” 为右对齐。写法如下：
Name | Academy | score
-| :-: | -:
Harry Potter | Gryffindor| 90
Hermione Granger | Gryffindor | 100
Draco Malfoy | Slytherin | 90

note1 : 对于特殊符号如果要求直接显示，可以通过反斜杠转义。2017/11/17 modified