打开APP
userphoto
未登录

开通VIP,畅享免费电子书等14项超值服

开通VIP
Markdown语法入门

关于第一篇博客是在说怎么用Markdown写博客的事情

身为搞代码的人,每次都是面向博客(CSDN,cnblog,stackoverflow)编程,久而久之,内心总会萌发一些创(ban)作(yun)的欲望。具体的原因在文末会有简单提及。工欲善其事,必先利其器。在开始写博客之前,首先我们得了解一种支持语法高亮的及其好用的程序员必备的轻量级标记语言————MarkDown。

Markdown语法

MarkDown最早由一个狂热的果粉约翰·格鲁伯(John Gruber)在2004年发明,他本人也是独立博客的坚定支持者。整体来说,这个人在国内并不出名,这里贴一个中文维基百科的链接:约翰·格鲁伯。知乎和某些社区里有不少dalao对于此人和Markdown语法有不少讨论,鉴于本人比较弱,就没办法加入其中,大家可以自行查阅。
我第一次接触markdown是在某次小组的合作任务中,在编写README文档和分工文档的时候,在github上使用了markdown。当时给我的感觉是,编写过程非常的简洁,没有多余的修饰,然后文本的展现效果也很清晰明朗(可惜的是当时我却不太会)。后来接触到更多的类似WordPress的平台都会支持使用MD编辑,于是我开始心动,下定决心要好好学一学。实际的过程确实也没有想象的那么复杂。

功能面板

博客园中的markdown功能面板比较简单,但基本上已经覆盖了常用的快捷方式:

编辑页面就是我们使用MD语法创作的地方,加入了很多标识符,而预览页面就是展示标记后的效果。编辑内容每隔几分钟就会自动在云端保存,防止丢失。而右方的小图标,从左至右依次是添加粗体,添加链接,添加代码,添加引用,添加表格,添加无序列表,添加有序列表,上传图片,全屏。除去"全屏"不会介绍,我还会补充添加标题和关于字体段落的修饰。当然本篇文章我打算介绍通用的语法,因为不同平台的快捷键有所不同,意义不是很大。

0.添加标题

格式:

# hello
## hello
### hello
#### hello
##### hello
###### hello 

下面是效果图:(某些平台上默认插入的是二级标题,而且会自带下划线,比如博客园)

hello

hello

hello

hello

hello
hello

在MD中,标题总共分为六级,使用(<=6)数量的#号+任意数量的空格+标题内容依次表示。一般来说中间的空格一定要有,否则MD无法识别这是标题语法,但是不知道为什么,博客园平台上的md好像可以识别无空格,但是建议大家还是养成良好的习惯,加上空格。

1.添加粗体/斜体

在你所要加粗的文字两边分别加上两个*就可以对所选文字加粗

**你好吗**
**我很好**

你好吗
我很好

在你所要斜体的文字两边分别加上一个*就可以实现对所选文字斜体

*Hey!*
*Happy Girls' Day!*

Hey!
Happy Girls' Day!

而同理,如果在文字两边各加上三个*可以实现对文字既加粗,又斜体

***学习吧***
***只有学习才是最靠谱的***

学习吧
只有学习才是最靠谱的

2.添加链接

添加超链接时,我们首先要打出一个[],在括号里需要加上超链接的名称(如果不加就是把整个链接变蓝),然后添加一对小括号,里面粘贴上你想要链接的地址
如下:

[markdown](https://baike.baidu.com/item/markdown/3245829?fr=aladdin)

效果就是这样:markdown

3.添加代码块

作为程序员,那最重要的显然就是搞代码了,md也很贴心的支持了语法高亮功能。首先我们需要在代码段的前面另起一行,打下三个“`”+语言(例如c,c++)
然后敲上你的代码,最后结束的时候再另起一行敲上三个反引号。这个符号位于小键盘的数字1左边,需要开启英文键盘模式。

(在这里添加)```c++
#include<iostream>
using namespace std;
int main(){
  cout << "hello world!" << endl;
  return 0;
}
(在这里添加)```

效果如下:

#include<iostream>
using namespace std;
int main(){
  cout << "hello world!" << endl;
  return 0;
}

4.添加引用

对于某些我们需要引用的文献,需要在原文中增添索引,并在文末给出链接的,可以使用这一功能。网上有很多种介绍方法,大多数是使用Html标签实现的。但是不知道怎么回事,在博客园里好像不太好用。我推荐一种类似于Word角标的方法,具体使用如下:
首先我们需要在想要增加索引锚点的内容后加入这样一些标识:

知网平台[^1]

然后就会在内容右上角展现索引:知网平台[1]
在文章的最后,我们可以加上如下的代码,来插入文献的引用地址:

## References: 
[^1]: - [1] [中国知网](https://www.cnki.net/) <div id="refer-anchor-1"><div>

这样就可以实现快速地检索与查找。

5.添加表格

表格一般包括表头和正文内容。在md语法里面,创建表格基本是由|,-,:这三个符号完成的,具体实现见下方:

| 左对齐文本 | 居中文本 | 右对齐文本 |
|:-------- |:-------:|--------:|
|图论与代数结构|  95     | 优秀     |
|形式语言与自动机|  85   |  良好     |
|体育        |    70    |  通过     |

效果如下:(注意其中的冒号要转为英文键盘输入,不然无法识别表格)

左对齐文本 居中文本 右对齐文本
图论与代数结构 95 优秀
形式语言与自动机 85 良好
体育 70 通过

功能虽然很简单,但是美观又实用。

6.添加无序列表

有时候我们会遇到需要分条论述的情况,这个时候,加上分级的列表就会显得清晰很多。这里的无序意思是没有序号。md支持在文本前使用*,-,+来进行分级,效果上大同小异。在这里,标识符和文本之间一定要有若干数量的空格,否则无法识别。同时,采用缩进的方式来表达所属关系。

* 第一层
  - 第二层
    + 第三层
  • 第一层
    • 第二层
      • 第三层

7.添加有序列表

顾名思义,有序列表就是加上序号。亲测每一层关系前至少需要缩进四个空格,否则无法识别。

1. balabala
    1. balabala
        1.balabala
  1. balabala
    1. balabala
      1.balabala

8.上传图片

图片链接和网页的超链接类似,但需要在[]前加上!方括号里填不填内容好像没有特别大的关系。在不同的博客平台,可能会先要求你上传图片到它的平台,然后得到一个图片的链接地址,填入后面的小括号即可。当然,你也可以自己从网页上扒图片获取链接地址,例如:

![(这是一张图片)](//image109.360doc.com/DownloadImg/2022/11/1820/256042743_2_20221118082141632.jpg)

我们也可以用下面的方法代替上面的,能偶同时实现图片的缩放:

<img src="//image109.360doc.com/DownloadImg/2022/11/1820/256042743_2_20221118082141632.jpg" width="50%">

9.字体、段落、背景修饰

修改字体种类、大小、颜色、背景需要用到html内嵌的font标签。颜色支持十六进制,字体需要使用双引号加注。我们直接上代码感受一下:

<font color=red>我是小红</front>
<font face="幼圆">我比较圆</font>
<font size=6>我很大</font>
<font size=7 color=#FF4500 face="幼圆">我又红又大又圆</font>

我是小红
我比较圆
我很大
我又红又大又圆

在文字背景色方面,可以采用<table>和<tr>等标签,

<table><tr><td bgcolor=#7FFFD4>这里设置的是原谅色</td></tr></table>
这里设置的是原谅色

还有一些实用的小技巧,譬如上划线、中划线、下划线等。其中下划线和上划线需要借用html标签和Latex数学公式[2]

~~中划线~~
$\overline{\text{上划线}}$
$\underline{\text{下划线}}$
<u>这也是一条下划线</u>

中划线
\(\overline{\text{上划线}}\)
\(\underline{\text{下划线}}\)
这也是一条下划线

最后贴上十六进制颜色图:

10.为什么要写blog

身为技术小白,身边很多人都劝说过我可以写一个博客记录一下技术成长的道路。总之感觉写起来并没有那么容易(可能是因为我比较菜)。无意间看到一篇博客强调了技术博对于新人的重要性。有的时候像我这样的新人入行,而且还是IT这样迭代速度如此之快的行业,缺乏系统的总结是相当要命的。这几天突然想起来,觉得非常有道理,生活貌似也是如此,不能总是停留在“这种情况我好像遇到过”,“应该是这样吧”云云。常常在同一个地方犯错,是不会长记性的。

References:


  1. ↩︎
  2. ↩︎
本站仅提供存储服务,所有内容均由用户发布,如发现有害或侵权内容,请点击举报
打开APP,阅读全文并永久保存 查看更多类似文章
猜你喜欢
类似文章
【热】打开小程序,算一算2024你的财运
Markdown简明教程:码字效率飞升80%,不懂代码也能hold住!
Pandoc中的Markdown语法
快速学会Markdown语法
高效编写工具-Markdown
马克飞象教程
专注写作 Markdown 语言 10 分钟速成
更多类似文章 >>
生活服务
热点新闻
分享 收藏 导长图 关注 下载文章
绑定账号成功
后续可登录账号畅享VIP特权!
如果VIP功能使用有故障,
可点击这里联系客服!

联系客服