10分钟带你入门Markdown

简介: 本指南系统介绍Markdown核心语法:标题、段落、换行、强调、引用、列表、代码块、分割线、链接、图片及转义字符,配示例与正误对比,助你30分钟快速掌握轻量级标记语言。

目录


  • Markdown介绍

Markdown是一种轻量级标记语言,通过简单的符号实现文本格式化。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。
Markdown的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。


  • Markdown标题语法

要创建标题,请在单词或短语前面添加井号# 。# 的数量代表了标题的级别。
|标题级别|Markdown语法|预览效果|
|:---:|:---:|:---:|
|一级标题|# Heading level 1|

Heading level 1

|
|二级标题|## Heading level 2|

Heading level 2

|
|三级标题|### Heading level 3|

Heading level 3

|

如果想在表格中展示一级,二级标题效果时推荐如下方式

<h1>Heading level 1</h1>
<h2>Heading level 1</h2>

重点注意❗❗

用一个空格在 # 和标题之间进行分隔。
|✅正确示范|❌错误示范|
|:---:|:---:|
| # 这是标题 |#这是标题|


  • Markdown段落语法

要创建段落,请使用空白行将一行或多行文本进行分隔。

Markdown语法中直接使用两次回车即可实现,但是在表格中我个人实践无法使用这种方式实现分段落,所以用HTML语法中<p>来实现
```html

我真的很喜欢使用 Markdown。

我想从现在开始我会用它来格式化我所有的文档。

##  重点注意❗❗
不要用**空格**或**制表符**缩进段落。

---

 - <h1 id="Markdown换行语法">Markdown换行语法</h1>

在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行。
>Markdown语法中在行末添加两个空格即可实现,但是个人认为HTML语法是可视化的更加容易查改,所以用HTML语法中`<br>`来实现
```html
<p>这是第一行。<br>
这是第二行。</p>

  • Markdown强调语法

通过将文本设置为粗体或斜体来强调其重要性。

  1. 粗体

要加粗文本,请在单词或短语的前后各添加两个星号**。

  1. 斜体

要用斜体显示文本,请在单词或短语前后添加一个星号*。

  1. 粗体和斜体

要同时用粗体和斜体突出显示文本,请在单词或短语的前后各添加三个星号,中间不要带空格。


|字体类型|Markdown语法|预览效果|
|:---:|:---:|:---:|
|粗体| **这是粗体** |这是粗体|
|斜体| *这是斜体* |这是斜体|
|粗体和斜体|***这是粗体和斜体***|这是粗体和斜体|


  • Markdown引用语法

  1. 单个段落引用

要创建块引用,请在段落前添加一个 符号。>

>这是一句引用

这是一句引用

  1. 多个段落的块引用

块引用可以包含多个段落。 为段落之间的空白行添加一个 符号。>

>这是第一句引用
>
>这是第二句引用

这是第一句引用

这是第二句引用

  1. 嵌套块引用

块引用可以嵌套。 在要嵌套的段落前添加一个 符号。>>

>这是一句引用
>
>>这是内嵌语句

这是一句引用

这是内嵌语句


  • Markdown列表语法

有序列表

要创建有序列表,在每个列表项前添加数字并跟一个英文句点(.),用一个空格分隔序号和内容。

1. 第一项
2. 第二项
  1. 第一项

  2. 第二项

    无序列表

    要创建无序列表,请在每个列表项前面添加破折号(-),用一个空格分隔序号和内容

 - 第一项
 - 第二项
  • 第一项
  • 第二项

    重点注意❗❗

    用一个空格在数字和句点(1.)或破折号(-)在内容之间进行分隔。
    |✅正确示范|❌错误示范|
    |:---:|:---:|
    | 1. 第一项 |1.第一项|
    | - 第一项 |-第一项|

  • Markdown代码语法

这里给出个人认为最简洁的方式围栏式代码块
要添加语法突出显示,请在代码块之前的反引号旁边指定一种语言。

```c
#include<stdio.h>
int main(){
    printf("Hello World");
}
```

呈现的效果如下:

#include<stdio.h>
int main(){
    
    printf("Hello World");
}

重点注意❗❗

三个反引号(```)不可以嵌套使用,如果想要嵌套需要三个波浪号(~~~)和三个反引号结合使用,否则会识别错误。


  • Markdown分割线语法

要创建分隔线,在单独一行上使用三个或多个星号 (*)、破折号 (---) 或下划线 (___) ,并且不能包含其他内容。

重点注意❗❗

请在分隔线的前后均添加空白行。
✅正确示范

尝试在之前插入一个空行

---

然后是水平分割线。

❌错误示范

没有空行,这将成为一个标题。
---
不要这样做!

  • Markdown链接语法

超链接Markdown语法代码:

这是一个链接 [Markdown语法](https://markdown.com.cn)。

呈现的效果如下:

这是一个链接 Markdown语法。

给链接增加 Title

链接title是当鼠标悬停在链接上时会出现的文字。

这是一个链接 [Markdown语法](https://markdown.com.cn "最好的markdown教程")。

呈现的效果如下:

这是一个链接 Markdown语法。

另一种更简洁方式

使用尖括号<>可以很方便地把URL或者email地址变成可点击的链接。

<https://markdown.com.cn>

呈现的效果如下:
https://markdown.com.cn


  • Markdown图片语法

插入图片Markdown语法代码:![图片alt](图片链接 "图片title")。

注意用一个空格在图片链接和图片注释之间进行分隔,否则会报错

![CSDN](https://i-blog.csdnimg.cn/direct/d4d8a51f42ef4b87a96a9f439e8567fb.png "CSDN博客")。

呈现的效果如下:


  • Markdown转义字符语法


    要显示原本用于Markdown 文档的字符,在字符前面添加反斜杠字符\。
    \- 如果没有反斜杠,这将是无序列表中的项目符号。
    
    呈现的效果如下:

- 如果没有反斜杠,这将是无序列表中的项目符号。

重点注意❗❗

反斜杠和要显示原本用于Markdown 文档的字符之间不能添加空格。

相关文章
|
10月前
|
人工智能 uml Perl
Markdown语法大全-Markdown从入门到精通
Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成结构化的HTML(或者其他格式)。Markdown的语法包括标题、段落、列表、链接、图片、代码等元素的简单标记。 对比我们日常使用的Word文档,Markdown的优势在于,兼容性更强,编辑时无需特定的软件就能打开,与此同时,基于Markdown编辑排版的文档,经过渲染就能一键转为标准的富文本文档,格式不易错乱,整体使用体验更佳。
2589 3
|
2月前
|
人工智能 运维 Linux
凌晨告警不再慌!SysOM 巡检 Skill 一键锁定根因
凌晨两点被叫醒,还要花 40 分钟拼出根因?阿里云操作系统控制台发布的 SysOM 巡检 Skill,沉淀了内核专家的排查经验,37 秒即可生成报告,巡检发现问题后自动衔接诊断、精准定位根因。目前 SysOM 巡检 Skill 已开源,一行命令即可立即上手,欢迎体验。
352 20
|
10月前
|
JavaScript 安全 人机交互
单节锂电池充电芯片核心选型:高可靠性充电方案技术精要
单节锂电池充电芯片核心选型:高可靠性充电方案技术精要
|
1月前
|
人工智能 自然语言处理 运维
企业Agent进入投标协作:如何设计可追溯、可恢复的人工交接点
企业Agent进入投标长任务后,需要记录输入版本、原文依据、当前产出、风险、责任人与人工放行状态,才能实现可追溯、可恢复的协作。
|
2月前
|
SQL Java 关系型数据库
38天Java项目实战打卡清单
38天Java实战打卡计划:分三阶段——12天夯实Java核心(面向对象、集合、多线程等),8天掌握MySQL与JDBC,18天全流程开发Tlias教学管理系统(含登录、权限、文件上传、图表统计等),最终产出可写进实习简历的完整项目作品。
|
4月前
|
Linux API 开发者
MarkText:一款被低估的开源 Markdown 编辑器
MarkText 是一款 **被严重低估** 的编辑器。它没有 Obsidian 的插件生态,也没有 Notion 的协作能力,但它做到了很多编辑器没做好的事:**把写 Markdown 这件事本身做到极致**。 干净的界面、流畅的实时预览、体贴的三种编辑模式、完整的规范支持,再加上 MIT 开源免费——如果你是一个纯粹的写作者,MarkText 就是你需要的那个工具。
2034 3
只要会发文,就能多一份收入?这 5 个平台,普通人可以先试起来
本文为普通人量身打造图文副业入门指南,梳理今日头条、百家号、知乎、微信公众号、小红书5大低门槛平台特点与实操策略,强调“先写起来、再优化、重积累”,避开盲目铺量、自嗨写作等常见误区,助你从0开始用内容沉淀粉丝、建立信任、实现多元变现。
|
7月前
|
XML 人工智能 JSON
markdown 为什么AI都用它
Markdown是AI时代的“通用语”:轻量省Token、结构清晰易读易解析、跨平台兼容强,且因训练数据丰富成为大模型默认输出格式。它平衡人类可读性与机器可解析性,让AI响应更规范、高效、低成本。(239字)
|
9月前
|
人工智能 JSON 并行计算
建议收藏:大模型模型实战手册,让你的AI从“通才”变成“专才”
本文深入浅出地讲解了如何让大模型真正懂你的业务。针对开源模型“胡说八道”的痛点,系统拆解CPT、SFT、DPO三大微调技术,结合Qwen 2.5、Llama 3等主流模型实战对比,并手把手指导数据准备、环境配置与训练优化,助你用低成本打造专属AI专家,少走半年弯路。
511 2

热门文章

最新文章