Github博客平台搭建（二）：通用标记语言Markdown入门

发表于 | 分类于 ，

【引言】Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。此篇文章用于介绍其基础语法用法。


基础语法篇

标题

  一般在行首加井号表示不同级别的标题 (H1-H6)，例如：## H1, ### H2

1
2
3
4
5
6
# 这是H1
## 这是H2
### 这是H3
#### 这是H4
##### 这是H5
###### 这是H6

斜体和粗体

  一般使用左右各1个*号进行包围的部分，是斜体：

  • 我就是斜体

  一般使用左右各2个*号进行包围的部分，是粗体：

  • 我就是粗体

外部链接引用

  一般使用如下语法：[描述内容](链接地址) 添加外部链接

无序列表

  一般添加 *，+，- 于列表描述前表示无序列表

  • 无序列表1
    • 无序列表2
    • 无序列表3

有序列表

  一般添加 数字加点 于列表描述前表示有序列表

  1. 有序列表1
  2. 有序列表2
  3. 有序列表3

文字引用

  • 一般使用 > 表示文字引用，本条说明本身使用的就是文字引用语法样式。
  • 引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等：
  • 区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 > ；比如

    我是第二层引用

行内代码块

  一般使用 `代码内容` 表示行内代码块。

  • 怎么给方法设置默认返回值呢？public int length() default 255;

代码块

  一般使用 四个缩进空格 表示大段的代码块；但为了美观和显示效果清晰，我一般更倾向于使用带高亮和行数的模式（也就是下面一节说到的），其实代码不仅仅是完成功能，也是一种产品，所以我个人的追求是在格式上力求看着舒服！

代码块高亮和行数显示

  一般使用 ```代码开发语言 开头，以 ``` 结尾包围的代码块即可进行高亮和行数显示

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
public static String extractVideos(String sourceUrl, String filePath, CrawlRegular regular) {
    
    try{
        // 读取文件
        Document doc = Jsoup.parse(StreamIOUtil.read(filePath));

        // 取全文Elements
        Elements els = doc.children();
        if (null == els) {
            return null;
        }
            
        // 根据xPath取得匹配区域，只要存在，则证明该页面是视频页面
        Elements xPathEles = els.select(regular.getxPath());
        if (null != xPathEles && xPathEles.size() > 0) {
            return sourceUrl;
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
    return null;
}

插入图像

  一般使用 使用![描述](图片链接地址) 插入图像，当然也可以用HTML语言的div来实现（考虑到能想得起玩儿Markdown的同学应该都有些编程基础，所以这里就不赘述了），Please enjoy this moment!

分隔线

  一般在一行中用三个以上的 *、-、_ 来建立一个分隔线，行内不能有除空格以外的其他内容

  • 我是多*分隔线
  • 我是多-分隔线
  • 我是多_分隔线

反斜杠

  一般使用 \特殊字符 进行字符转义（类似编程语言）

  • 我就是要展示星号，就在星号前面加入反斜杠（*）

进阶语法篇

表格基本语法

1
2
3
4
5
| 水果        | 价格    |  数量  |
| --------   | -----:   | :----: |
| 香蕉        | $1      |   5    |
| 苹果        | $1      |   6    |
| 草莓        | $1      |   7    |
水果 价格 数量
香蕉 $1 5
苹果 $1 6
草莓 $1 7

表格转换工具

  使用大杀器转换工具: exceltk

1
2
3
4
5
6
7
8
9
10
整个表格：    exceltk.exe -t md -xls xxx.xls  
              exceltk.exe -t md -xls xxx.xlsx
指定sheet：  
              exceltk.exe -t md -xls xx.xls -sheet sheetname   
              exceltk.exe -t md -xls xx.xlsx -sheet sheetnameexceltk
特性：
     转换Excel表格到MarkDown表格
     支持Excel单元格带超链接
     如果Excel里有合并的跨行单元格，在转换后的MarkDown里是分开的单元格，这是因为MarkDown本身不支持跨行单元格
     如果Excel表格右侧有大量的空列，则会被自动裁剪，算法是根据前100行来检测并计算

流程图

  使用 三个`加flow 起始，使用 三个` 结尾，语法参考：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
st=>start: Start|past:>http://www.google.com[blank]
e=>end: End:>http://www.google.com
op1=>operation: My Operation|past
op2=>operation: Stuff|current
sub1=>subroutine: My Subroutine|invalid
cond=>condition: Yes
or No?|approved:>http://www.google.com
c2=>condition: Good idea|rejected
io=>inputoutput: catch something...|request
st->op1(right)->cond
cond(yes, right)->c2
cond(no)->sub1(left)->op1
c2(yes)->io->e
c2(no)->op2->e

其他常用语法

常用HTML

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 插入图片，居中指定宽度
<img style="clear: both;display: block;margin:auto;" src="https://github.com/ttfisher/images/raw/master/2018/2018-06-04-03.jpg" width="55%">

# 字体或颜色设置
<font face="微软雅黑" color="red" size="6">字体及字体颜色和大小</font>
<font color="#0000ff">字体颜色</font>

# 文本不同的对齐方式
<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>

# 换行
使用html标签`<br/>`<br/>换行

# 特殊格式：下划线（加粗，斜体等都支持）
<u>下划线文本</u>
<b>加粗文本</b>
<i>斜体文本</i>

常见转义符

符号 说明 对应编码(+实际用时不需要) 英文怎么说
& AND 符号 & + amp; ampersand
< 小于 & + lt; little
> 大于 & + gt; great
空格 & + nbsp; number space
¿ 倒问号 & + iquest; inverted question
? 问号 & + quest; question
« 左书名号 & + laquo; left angle quote
» 右书名号 & + raquo; right angle quote
“ 引号 & + quot; quote
‘ 左单引号 & + lsquo; left single quote
’ 右单引号 & + rsquo: right single quote
“ 左双引号 & + ldquo: left double quote
” 右双引号 & + rdquo: right double quote
段落符号 & + para; paragraph
§ 章节符 & + sect; section
× 乘号 & + times; times
÷ 除号 & + divide; divide
± 加减号 & + plusmn; plus minus
ƒ function & + fnof; 还没查到
√ 根号 & + radic; radic
∞ 无穷大 & + infin; infinite
° 度 & + deg; degree
≠ 不等号 & + ne; ne
≡ 恒等于 & + equiv; equivalent
≤ 小于等于 & + le; less than or equal to
≥ 大于等于 & + ge; great than or equal to
⊥ 垂直符号 & + perp; perpendicular
← 左箭头 & + larr; left arrow
→ 右箭头 & + rarr; right arrow
↑ 上箭头 & + uarr; up arrow
↓ 下箭头 & + darr; down arrow
↔ 水平箭头 & + harr; horizontal arrow
↕ 竖直箭头 & + varr; vertical arrow
⇐ 双线左箭头 & + lArr; left arrow
⇒ 双线右箭头 & + rArr; right arrow
⇑ 双线上箭头 & + uArr; up arrow
⇓ 双线上箭头 & + dArr; down arrow
⇔ 双线水平双箭头 & + hArr; horizontal arrow
⇕ 双线竖直箭头 & + vArr; vertical arrow
♠ 黑桃 & + spades; spades
♥ 红桃 & + hearts; hearts
♣ 梅花 & + clubs; club
♦ 方块 & + diams; diamonds
© 版权 & + copy; copy right
® 注册商标 & + reg; registration
™ 商标 & + trade; trade
¥ 人民币 & + yen;
€ 欧元 & + euro; euro
¢ 美分 & + cent; cent
£ 英磅 & + pound; pound
⊕ & + oplus;
½ 二分之一 & + frac12; fraction
¼ 四分之一 & + frac14; fraction
‰ 千分符号 & + permil; per mille
∴ 所以 & + there4; there fore
π 圆周率 & + pi;
¹ 商标1 & + sup1; super 1
α alpha & + alpha; alpha
β beta & + beta; beta
γ gamma & + gamma; gamma
δ delta & + delta; delta
θ theta & + theta; theta
λ lambda & + lambda; lambda
σ sigma & + sigma; sigma
τ tau & + tau; tau

------2019 Lin.C ------