markdown学习笔记

前序

  本文分为两部分,第一步为markdown的语法部分,第二部分为应用篇,在实际应用中总结markdown的使用技巧。markdown的语法部分比较简单,基本上稍加记忆都能够很好地使用。重点应放在日常使用markdown时的遇到的问题,以及相应的解决技巧或办法。

语法部分

标题

  markdown中共有六级标题,格式为# 标题(此处有空格)。符号#的个数对应标题的层级。

一级标题

二级标题

三级标题

字体样式

  常用的字体样式有:粗体,斜体,粗斜体,删除线等。粗体用**文本内容**表示,斜体用*文本内容*表示,删除线用~~文本内容~~表示。
我是粗体
我是斜体
我是粗斜体
这是一条删除线

引用

  引用是用>文本内容的格式来表示,代码引用通过```文本内容```或者tab文本内容(四个空格)文本内容表示。一条语句用一个`包起来,多段代码则用三个`包起来。

下面这段代码只是一个示例。

inp = input('Enter a Number:')
n = int(inp)
while n != 1:
    print(n, end=' ')     # Use comma to suppress newline
    if n % 2 == 0:        # n is even
        n = n / 2
    else:                 # n is odd
        n = n * 3 + 1

表格

  markdown对表格的支持并不友好,推荐使用HTML来绘制表格。

|表头|表头|表头|
|-:|:-:|:-|
|右对齐|居中|左对齐|
|hello|world|markdown|
表头 表头 表头
右对齐 居中 左对齐
hello world markdown

脚注

  脚注是成对出现的。一般用[^1]作为标记,[^1]:注释内容作为注释。注释内容的位置随意,但始终显示在文末。点击脚注会跳至注释,点击注释会返回脚注标记。
文本编辑器[1]
markdown[2]

插入图片、链接

  图片用格式!()[]表示,而链接则用格式[]()表示。注意,方括号和圆括号,以及感叹号均为半角。

markdown

最实用的十条Markdown语法

分割线

  可以通过用连续的---或者***或者___(三个下划线)来绘制一条分割线,效果如下:


  注意:在分割线之前应空一行,否则容易出错。

列表

  列表一般分为无序列表和有序列表。无序列表通过+*-来表示,注意空格。

* 这是一项;
+ 这是第二项;
- 这是第三项;
  • 这是一项;
  • 这是第二项;
  • 这是第三项;

  而有序列表则使用1.的形式。同样的,需要注意空格。

1. 这是一项;
2. 这是第二项;
3. 这是第三项;
  1. 这是一项;
  2. 这是第二项;
  3. 这是第三项;

缩进

  在每一行的起始位置,输入以下代码,接着继续写文本即可。

全角空格: 或 
半角空格: 或 
不换行空格 或 ;

  这样做很麻烦,这是因为markdown本身不负责首行缩进这个功能。可以采用的另一种方法如下,来自于知乎问题:在 Markdown 语言中,如何实现段首空格的显示

推荐全角空格,切换到全角模式下(一般的中文输入法都是按 shift + space)输入两个空格就行了。这个相对 来说稍微干净一点,而且宽度是整整两个汉字,很整齐。

  本人在使用该方法的过程中发现,在某些markdown语法(如代码引用、标题等)后面,采用这种方式进行缩进会出现无法显示的问题。即使空一行也无法解决。暂时只能在这种情况下采用第一种方法。

上下标

  上下标可以通过两种方式来实现。第一种方法将其视为数学公式,具体实现如下:
    1. 公式的编辑都在符号$之间;
    2. 符号^后接的字符为上标;
    3. 符号_后接的字符为下标;
    4. 如果存在多个下标,要用符号{}包起来。

$x^n_{ij}$

  上面代码的显示效果为:。注意:上标和下标的顺序没有先后差别。
  第二种方式则是采用HTML标签来实现。在HTML语言中,上标通过标签来实现,而下标则通过标签来实现。

n2 = n + 1
a = log2b
商标符号:Apple®;
function符号:ƒ(x) = x2
根号:√5
角度符号:30°

n2 = n + 1
a = log2b
商标符号:Apple®
function符号:ƒ(x) = x2
根号:√5
角度符号:30°
  更多HTML特殊符号可以参阅HTML中的特殊符号

数学公式

  markdown中编辑数学公式基本是采用Latex格式。


  1. 用来编辑文本的软件。 ↩

  2. 一种轻量标记语言. ↩

你可能感兴趣的:(markdown学习笔记)