专业编程基础技术教程

网站首页 > 基础教程 正文

markdown基础语法 markdown使用教程

ccvgpt 2024-10-22 10:39:41 基础教程 11 ℃

之前分享了个使用Hexo搭建的blog,但是它是需要需要Markdown语法,下面简单记录下的常用的用法,Markdown是一种简单的格式化文本的方法,使用非常方便,一旦熟练了,基本上就离不开他了,目前主流的博客平台都基本支持了,只要写好了内容,都可以渲染出不错的效果。那马上开始吧

标题

Markdown支持6种级别的标题,对应html标签 h1 ~ h6

markdown基础语法 markdown使用教程

 # h1
 ## h2
 ### h3
 #### h4
 ##### h5
 ###### h6

段落及区块引用

需要记住的是,Markdown其实就是一种易于编写的普通文本,只不过加入了部分渲染文本的标签而已。其最终依然会转换为html标签,因此使用Markdown分段非常简单,前后至少保留一个空行即可。

而另外一个比较常见的需求就是,我们可能希望对某段文字进行强调处理。Markdown提供了一个特殊符号>用于段首进行强调,被强调的文字部分将会高亮显示

 > 这段文字将被高亮显示...

以上标记显示效果如下:

这段文字将被高亮显示...

插入链接或图片

Markdown针对链接和图片的处理也比较简单,可以使用下面的语法进行标记

 [点击跳转至百度](http://www.baidu.com)
 ![图片标题](https://img.alicdn.com/tfs/TB1WeJ9Xrj1gK0jSZFuXXcrHpXa-195-195.png)

注: 引用图片和链接的唯一区别就是在最前方添加一个感叹号。

点击跳转至百度

列表

Markdown支持有序列表和无序列表两种形式:

  • 无序列表使用*或+或-标识
  • 有序列表使用数字加.标识,例如:1.
 * 黄瓜
 * 玉米
 
 + 黄瓜
 + 玉米
 
 - 黄瓜
 - 玉米
 
 1. 黄瓜
 2. 玉米

以上标记显示效果如下:

  • 黄瓜
  • 玉米
  • 黄瓜
  • 玉米
  • 黄瓜
  • 玉米
  1. 黄瓜
  2. 玉米

分隔线

有时候,为了排版漂亮,可能会加入分隔线。Markdown加入分隔线非常简单,使用下面任意一种形式都可以

 ***
 ---


产生分隔线的语法要求比较松,符号之间添加空格也可以。

强调

有时候,我们希望对某一部分文字进行强调,使用*或_包裹即可。使用单一符号标记的效果是斜体,使用两个符号标记的效果是加粗

 *这里是斜体*
 _这里是斜体_
 
 **这里是加粗**
 __这里是加粗__

这里是斜体 这里是斜体

这里是加粗 这里是加粗

高级用法

插入代码块

Markdown在IT圈子里面比较流行的一个重要原因是,它能够轻松漂亮地插入代码。

方法是,使用反引号`进行包裹即可。如果是行内代码引用,使用单个反引号进行包裹

这是一段var x = 3行内代码

如果插入一整段代码,需要至少使用两个以上反引号进行包裹, 看效果:

 fun (x: Int, y: Int): Int {
   return x + y
 }

注:很多人不知道怎么输入反引号。在英文模式下,找到键盘最左侧esc键下面的第一个键点击即可。

插入表格

表格是Markdown语法中比较复杂的一个,其语法如下:

 表头|条目一|条目二
 :---:|:---:|:---:
 项目|项目一|项目二

以上标记显示效果如下:

表头

条目一

条目二

项目

项目一

项目二

注:三个短斜杠左右的冒号用于控制对齐方式,只放置左边冒号表示文字居左,只放置右边冒号表示文字居右,如果两边都放置冒号表示文字居中。

其它

特殊符号处理

Markdown使用反斜杠\插入语法中用到的特殊符号。在Markdown中,主要有以下几种特殊符号需要处理:

 \   反斜线
 `   反引号
 *   星号
 _   底线
 {}  花括号
 []  方括号
 ()  括弧
 #   井号
 +   加号
 -   减号
 .   英文句点
 !   惊叹号

例如,如果你需要插入反斜杠,就连续输入两个反斜杠即可:\ => \ 。

注:在内容中输入以上特殊符号的时候一定要注意转义,否则将导致内容显示不全,甚至排版混乱。

如何给文字上色

Markdown的最初目标就是为纯写作而生的。因此,它并没有考虑文字颜色这一点。但是可以使用html的标签来设置颜色

 <font color='#ff0000'>设置颜色为红色</font>
 <font color='#0000ff'>设置颜色为蓝色</font>

效果如下

设置颜色为红色

设置颜色为蓝色

最近发表
标签列表