Markdown语法 - 基础

本文介绍了Markdown的基本语法,包括标题、加粗、斜体、分割线、列表、引用、表格、代码段、图片插入及超链接等元素的使用方法。

1、使用标题

Markdown可以使用#来标示标题。一个#后面跟的内容是一级标题,一般一级标题是文章的大标题。两个#,后面跟的内容是二级标题,依次类推。正文中的标题,一般用二级标题。
Markdown中一共可以使用6种标题,他们的格式可表示如下:

一级标题

二级标题

三级标题

四级标题
五级标题
六级标题

上述格式的Markdown代码如下:

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

2、加粗、斜体

  • 文本加粗比较简单,只需要使用**将需要加粗的文本包含在中间就可以了。
  • 文本斜体和文本加粗使用差不多,仅仅需要将两个星号改成一个星号就可以了。
    加粗和斜体显示的样式如下:

加粗
斜体

有些情况下既需要加粗又需要斜体,那么将两个合起来使用,使用三个星号就能达到目的:
斜体还加粗

编辑的代码如下:

**加粗**
*斜体*
***斜体还加粗***

3、分割线

分割线的使用方法:空一行后,使用三个以上的短线、星号、或者下划线。
编辑显示效果如下:




编辑代码:

---
***
___

4、列表

列表有两种,一种是无序列表,使用一些图标标记,没有序号;一种是有序列表,使用数字标记。

4.1 无序列表

在‘-’号之后加一个空格,再跟列表项的内容。
- 无序列表

- 无序列表

也可以使用多级无序列表,只需要在低层列表符号之前再加一个空格。
- 无序列表
- 无序列表1
- 无序列表2
- 列表2

- 无序列表
 - 无序列表1
 - 无序列表2
- 列表2 

4.2 有序列表

有序列表就是在每项列表的前面有一个数字标号的列表。使用方法是: 在数字和“.”号之后加一个空格,再跟列表项的内容。
1. 列表1
1.1 列表1.1
1.2. 列表1.2
2. 列表2
2.1. 列表2.1
2.2. 列表2.2

1. 列表1
 1.1. 列表1.1
 1.2. 列表1.2
2. 列表2
 2.1. 列表2.1
 2.2. 列表2.2

5、引用

引用比较简单,在“>”符号之后跟一个空格,然后添加引用内容。

这是引用

>这是引用

6、表格

如下表格:

产品名称单价数量日期
AA2.121002016-5-23
BB1.125002016-5-23
CC5.232002016-5-23
| 产品名称 | 单价 | 数量 | 日期 |
|:--- |:---:| ---:| :---:|
| AA | 2.12 | 100 | 2016-5-23 |
| BB | 1.12 | 500 | 2016-5-23 |
| CC | 5.23 | 200 | 2016-5-23 |

表格表项中文字显示靠左,居中还是靠右,就是由表格的上述代码中的第二行来决定的,:符号在左边表示的就是靠左,两边都有表示居中,在右边则表示靠右。

7、代码段

代码段是常见的插入内容,其实前面的实例代码都是以这种方式编辑进去的。代码段的插入也比较简单,有三个连续的`符号包括就可以了。

#include <iostream>
using namespace std;
int main(){
  return 0;
}
```cpp
#include <iostream>
using namespace std;
int main(){
  return 0;
}

8、插入图片

插入图片的语法:感叹号 ! 后跟一个中括号[],中括号中可以添加说明文字,后面再添加一个小括号(),小括号中输入插入图片的网址。
例如:

![图片](http://www.csdn.cn/images/abc.png)

9、超链接

9.1 直接加入超链接

中括号后跟一个小括号,中括号中加入提示的文字,圆括号中加入的是超链接,例如:
ABCD

[ABCD](www.baidu.com)

9.2 类似论文中引用的格式

引用1
引用2

[引用1][1]
[引用2][2]
[1]: http://blog.youkuaiyun.com/
[2]: http://blog.youkuaiyun.com/
### markdown-it 使用指南和示例 #### 安装 `markdown-it` 为了使用 `markdown-it`,首先需要将其集成到开发环境中。可以通过 npm 或者 yarn 来安装此库: ```bash npm install markdown-it ``` 或者通过 yarn: ```bash yarn add markdown-it ``` #### 基本用法 创建并初始化一个新的 `markdown-it` 实例非常简单。下面是一个简单的例子来展示如何解析一段 Markdown 文本[^5]。 ```javascript const MarkdownIt = require('markdown-it'); const md = new MarkdownIt(); console.log(md.render('# Hello World!')); // 输出: <h1>Hello World!</h1> ``` 这段代码会输出 HTML 版本的标题 "Hello World!"。`markdown-it` 支持多种不同的语法元素,包括但不限于标题、列表、链接以及强调文字等标准 Markdown 功能。 #### 扩展功能 除了基础的功能外,还可以利用各种插件扩展其能力。例如,可以添加 TOC (Table of Contents) 插件以便自动生成目录;也可以加入脚注支持以增强文档的表现力;对于数学表达式的处理,则有专门针对 LaTeX 数学公式的解决方案;最后还有 Vue 组件的支持让前端开发者能够更轻松地嵌入富文本编辑器。 ##### 添加 TOC 插件 要实现自动化的章节导航栏效果,可选用 `markdown-it-toc-done-right` 这样的第三方插件来进行设置[^1]: ```javascript const tocPlugin = require('markdown-it-toc-done-right'); md.use(tocPlugin); ``` ##### 启用脚注特性 如果想要给文章增加额外的信息备注而不会打断正文阅读流的话,那么启用 `markdown-it-footnote` 是个不错的选择[^2]。 ```javascript const footnotePlugin = require('markdown-it-footnote'); md.use(footnotePlugin); ``` ##### 处理数学公式 当涉及到科学计算和技术写作领域时,可能需要用到复杂的数学符号表示方法。这时就可以考虑引入像 `markdown-it-katex` 一样的专用插件来解决这个问题[^3]。 ```javascript const katexPlugin = require('markdown-it-katex'); md.use(katexPlugin); ``` ##### 整合 Vue.js 应用程序 为了让基于 JavaScript 框架的应用更加灵活多变,不妨尝试一下专门为 Vue 设计的 `markdown-it-vue` 工具包吧[^4]! ```javascript import { createApp } from 'vue'; import App from './App.vue'; createApp(App).use(require('markdown-it-vue')).mount('#app'); ```
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

空空的司马

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值