Markdown是什么?

Markdown是一种「标记语言」,通常为程序员群体所用。除此之外,Markdown也是国际杂志编辑以及许多写作者都广泛使用的标记语言。

本熊博客建站初入门,博客的所有文章都将使用这一语言写成。

为什么要用Markdown?

举个例子解释

大部分作家都是用 Word 或 Pages 写作,过去的文档也大都以微软的 .doc, .docx 格式或是苹果的 Pages 格式储存。还有人为了保证文稿发给谁都能正常打开,会用 .txt 格式。

但是.doc 或 Pages 格式有如下问题:

  • 1.不一定谁都能打开。用 Windows 的人打不开苹果的 .pages 文件,用旧版 Word 的人不一定能打开你用新版 Word 写的稿子。
  • 2.对方看到的稿子的样子和你自己看到的可能差别很大。
  • 3.大部分人电脑上的Office都是盗版的,使用时很容易出问题。
  • 4.用.txt 写的稿子没有格式,这就给编辑你文章的人带来困扰了。

到大学时我们会发现用Latex语言代码生成的论文既美观又简洁,那么写普通的博客呢?这就是 Markdown 登场的时候了。

千万不要被「标记」、「语言」吓到,Markdown的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。

但就是这十个不到的标记符号,却能让人优雅地沉浸式记录,专注内容而不是纠结排版,达到「心中无尘,码字入神」的境界。

Markdown 的优点

纯文本,所以兼容性极强,可以用所有文本编辑器打开。

兼顾了「什么人都能打开」和「样式」。Markdown 就是纯文本,就是 .txt,所以什么人都能打开。而如上所述,你可以用它来标记文本的样式,而且语法非常简单。
由于是纯文本,Markdown 文稿也不会因为未来软件升级而产生不同版本之间的兼容问题,即,不会出现「我这篇稿子是用旧版 Word 写的,你用新版 Word 看可能格式会有点问题」的情况。

让你专注于文字而不是排版。

格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。

Markdown 转 HTML 非常方便。HTML 是整个万维网(web)的标记语言,但更重要的是,它也是目前主流电子书格式所用的标记语言。无论是 EPUB, mobi,还是 Kindle 用的专有格式 .azw,都只是把一堆 HTML 文件打包而已。如果你写的是书,用 Markdown 标注格式之后,可以很方便地转为以上格式(当然这个转换工作不需要由你来做);如果你写的是单篇的文章(例如新闻报道或专栏),未来也不排除结集出书的可能。若采用 Markdown,对于日后的文件转换工作也大有裨益。
如何开始用 Markdown?继续用你习惯的写作软件即可。记事本、Word、Pages 都没问题,但请记得存成纯文本格式。就这么简单。

Markdown 的标记语法有极好的可读性。

标题

这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题格式。

而在 Markdown 中,你只需要在文本前面加上 # 即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。

例如:

    # 一级标题
    ## 二级标题
    ### 三级标题
    #### 四级标题
    ##### 五级标题
    ###### 六级标题

效果如下:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

注:# 和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。标题只有六个级别

分段换行

换行有多种办法,这里只举三个简单的:

  1. 换行:

    • 两段文字之间敲两个或以上的空格符
    • 两段文字之间添加标签<br/></br>
  2. 分段:

    • 两段文字之间空一行

字体

几种特殊强调字体:粗体、斜体、粗斜体、删除线。

例如:

    *这是斜体*
    **这是粗体**
    ***这是斜体加粗体***
    ~~这是删除线~~

效果如下:

这是斜体
这是粗体
这是斜体加粗体
这是删除线

列表

列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 -+- 任意一个就可以了,还可以按Tab建进行嵌套。

例如:

    - 文本1
        - 文本2
            - 文本3
    * 文本4
    + 文本5

效果如下:

  • 文本1

    • 文本2

      • 文本3
  • 文本4
  • 文本5

如果你希望有序列表,
也可以在文字前面加上 1. 2. 3. 就可以了。

例如:

    1. 文本1
       1. 文本2
       2. 文本3
    2. 文本3

效果如下:

  1. 文本1

    1. 文本2
    2. 文本3
  2. 文本3

注:-、1. 和文本之间要保留一个字符的空格。

引用

在我们写作的时候经常需要引用他人的文字,这个时候引用这个格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上 > 就好了。

例如:

    >欢迎关注“朽熊的博客”  
    >鲁迅说过:
    >>悲剧将人生的有价值的东西毁灭给人看,喜剧将那无价值的撕破给人看。

注:> 和文本之间要保留一个字符的空格。

最终显示的就是:

欢迎关注“朽熊的博客”
鲁迅说过:

悲剧将人生的有价值的东西毁灭给人看,喜剧将那无价值的撕破给人看。

线条

在markdown语法中,一行连用三个或者三个以上的星号,减号,或者下划线,就可以表示分割线.

    ***
    ---
    ___

效果如下:



_

代码块

短代码

在一般的段落文字中,可以使用反引号 
` (~ 键)
来标记或插入代码区段。

例如:

    C语言里的函数 `scanf()` 怎么使用?
    这样可以引用反引号 `` ` ``

效果如下:

C语言里的函数 scanf() 怎么使用?
这样可以引用反引号  `  

多行代码

  • 在需要高亮的代码块的前一行及后一行使用三个或以上的反引号 ` ``
  • 同时第一行反引号后面,输入代码块所使用的语言,实现代码高亮。

比如高亮 python3 代码块

例如:

    /```python
    #!/usr/bin/env python3
    print("Hello, World!");
    /```

效果如下:

#!/usr/bin/env python3
print("Hello, World!");

超链接

在 Markdown 中,插入链接不需要其他按钮,你只需要使用 显示文本 这样的语法即可。

例如:

    [朽熊的博客](https://hxear.top)

效果如下:

朽熊的博客

图片

在 Markdown 中,插入图片不需要其他按钮,你只需要使用 [图片名](图片地址) 这样的语法即可。

例如:

    ![本文章标题图](https://i.loli.net/2019/11/27/UnBYXSCcQi13t4q.jpg)

效果如下:

本文章标题图

注:插入图片的语法和链接的语法很像,只是前面多了一个 !
图片地址可以用本地图片,也可以使用图床。
本熊这里用的是SM.MS图床,配合上效率工具Quicker的插件调用SM.MS的API,可以快速将本地图片或者剪板贴中的图片上传图片到图床
quicker_1777c169-a2ae-4017-87b1-54d1c6b67797.png

表格

Markdown 制作表格使用|来分隔不同的单元格,使用-来分隔表头和其他行。

语法格式如下:

    |  表头   | 表头  |
    |  ----  | ----  |
    | 单元格  | 单元格 |
    | 单元格  | 单元格 |

效果如下:

表头表头
单元格单元格
单元格单元格

我们可以设置表格的对齐方式:

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐。

例如:

    | 左对齐 | 右对齐 | 居中对齐 |
    | :----- | ----: | :----: |
    | 单元格 | 单元格 | 单元格 |
    | 单元格 | 单元格 | 单元格 |

效果如下:

左对齐右对齐居中对齐
单元格单元格单元格
单元格单元格单元格

代办清单To-do List

你可以在Markdown中编写代办清单

相关代码:

    - [x] 已完成项目1
      - [x] 已完成事项
      - [ ] 代办事项
    - [ ] 代办项目2
    - [ ] 代办项目3

效果如下:

  • [x] 已完成项目1

    • [x] 已完成事项
    • [ ] 代办事项
  • [ ] 代办项目2
  • [ ] 代办项目3

Mrkdown编辑器

本熊大学专业读的物理,最喜欢的事情就是用最少的东西做最多的事,VS Code编辑器满足了我大部分的使用需求,他其中还有许多插件

直接在他的插件中心搜索markdown就可以找到很多的插件

最受推荐的插件:markdown-all-in-one

在所有拓展插件中,这个插件基础功能最全,快捷键多,方便使用。其中也包含latex公式编辑(具体看2.8),但是能否完全有效识别需要测试,笔者未做实验。

转义字符

markdown和html在语法上有类似的痛点
那就是一些想显示的符号最后都被识别成的语法标签。

这时就需要用转移符号来显示这些符号

其实非常简单,只需要在想显示的符号前面加个 \ 就可以了

\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号
\` 反引号
…
Last modification:December 6th, 2019 at 08:17 pm
如果觉得我的写的还有点意思,欢迎看官赞赏