百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

2024年保姆级教程 带你全面了解 markdown 语法

zhezhongyun 2024-12-22 21:55 46 浏览

新人求关注?,点击右上角 ↗? 关注,博主日更,全年无休,您的关注是我的更新的动力~ 感谢大家了

markdown 作为文本编辑最通用的文件格式,以其语法简单而得到广泛的使用和传播。今天我们来全面盘点一下 markdown 的语法。

什么是Markdown?

Markdown是一种轻量级标记语言,可以通过简单的文本编辑器创建格式化文本。

John Gruber于_2004年_与Aaron Swartz合作创建了Markdown,旨在提供一种易于阅读的标记语言。

Markdown广泛用于博客、即时消息、在线论坛、协作软件(如GitHub)、文档页面和README文件中。

为什么选择Markdown?

Markdown是一个简洁而强大的内容编辑工具,是GitHub等平台的标准选择。它在各种浏览器和客户端编辑器中都能很好地发挥作用。

虽然HTML可以精确地呈现内容,但它占用空间较大,即使是少量使用也可能会让人感到麻烦。Markdown的发明提供了在HTML的强大描述功能和纯文本的编辑简便性之间的一个极佳的折衷方案。

Markdown语法

1. 强调文本

通过使用两个星号(**)或两个下划线(__)来创建加粗文本。

Markdown加粗文本:
这是**加粗**文本。
这也是__加粗__文本。

结果:

这是加粗文本。
这也是
加粗文本。

通过使用单个星号*或单个下划线_来创建_斜体_文本。

Markdown斜体文本:
这是*斜体*文本。
这也是_斜体_文本。

结果:


使用双波浪线 ~~ 创建删除线文本。

Markdown删除线文本:
~~删除线~~

结果:

使用---___***创建水平分割线。

Markdown水平分割线:

---

结果:

若要使用星号符号,需要在前面加上反斜杠\。例如,以下示例会在输出中显示下划线和星号。

\_这是全部\*\*普通\*\*文本\_。

结果:

2. 引用文本

你可以使用大于号>字符创建块引用。

Markdown引用文本:
> 这是引用的文本。

结果:

这是引用的文本。

3. 代码

使用单个反引号 ` 标记单行代码,使用三个反引号 ` 标记代码块。

Markdown单行代码:

var first = 1;
var second = 2;
var sum = first + second;   

4. HTML扩展

如果遇到Markdown不支持的HTML场景,可以在Markdown中直接内联使用HTML。

使用HTML的Markdown示例:
这里是<br />换行符

结果:

这里是
换行符

5. 标题

这些标题与HTML中的<h1>标签非常相似。
你也可以在标题下方放置一个等号=来表示一级标题,或使用连字符-表示二级标题。

# - 一级标题(最大)
## - 二级标题
### - 三级标题
#### - 四级标题
##### - 五级标题
###### - 六级标题(最小)

6. 列表

你可以定义有序无序列表。通过缩进可以定义嵌套项。

  • 有序列表以数字开头。
  • 无序列表以连字符-、星号*或加号+开头。

Markdown无序列表:

  • 第一项
  • 嵌套项
  • 第二项
  • 第三项

Markdown有序列表:

  1. 第一项
  2. 第二项
  3. 第三项

7. 链接

通过将链接名称放在方括号[]中,然后紧挨着将实际链接放在圆括号()中来创建一个链接。
图片和网站链接的语法相似。

Markdown网站链接:
[Microsoft Learn](https://xxxx.com)

Markdown图片链接:
![链接一个图片](https://xxxxx)

markdown 语法变体

诸如_GitHub_等网站使用了Markdown的变体,使用户之间的讨论更加方便。当然这些变体语法还是基于 markdown 基本的语法进行扩展的,大体上不会差太多

小结

如你所见,Markdown的语法十分易于理解,掌握这些基础语法就足够你撰写出格式优美的文档。赶快尝试一下吧!

欢迎留言评论,大家一起探讨,一起进步~ 欢迎点赞、关注?、转发~

求关注~全年无休日更~ 求关注~

相关推荐

3 分钟!AI 从零开发五子棋全过程曝光,网友:这效率我服了

<!DOCTYPEhtml><htmllang="zh-CN"><head><metacharset="UTF-8...

一行代码实现display&quot;过渡动画&quot;原理

作者:Peter谭老师转发链接:https://mp.weixin.qq.com/s/XhwPOv62gypzq5MhhP-5vg写本文的起因上篇文章,提到如何让display出现过渡动画,却没有仔...

脑洞:琼恩·雪诺、蝙蝠侠和魔形女的灵魂宠物了解一下

AlekseiVinogradovisaRussianfreelancedigitalartistwhoshareshisskillsandtalentwith120k...

浏览器的渲染机制、重绘、重排

1、什么是重排和重绘网页生成过程:HTML被HTML解析器解析成DOM树css则被css解析器解析成CSSOM树结合DOM树和CSSOM树,生成一棵渲染树(RenderTree)生成布局(flo...

托福写作高频考题写作思路&amp;词汇丨考虫独家

科技话题与媒体话题是托福写作的常考话题很多考生对这两类话题里的专有词汇表达也许很不了解所以今天就跟随考虫托福写作老师刘云龙老师一起来学习在这些话题的写作里你可以使用哪些有用的表达。希望大家有收获!记得...

在优麒麟上使用 Electron 开发桌面应用

使用Web标准来创建桌面GUI,上手快、成本低、跨平台、自适应分辨率,这些都是Electron的优势。作者/来源:优麒麟Electron是由Github开发,用HTML、CSS和...

php手把手教你做网站(三十八)jquery 转轮盘抽奖,开盲盒

抽奖和开盲盒性质一样的都是通过ajax读取后台的随机数据。1、转轮盘本来是想直接绘图实现轮盘,但是没有找到怎么填充文字,只好把轮盘弄成了背景图,通常用于游戏抽道具,商城积分抽奖,公司年末员工抽奖点击抽...

用 CSS 整活!3D 轮播图手把手教学,快乐代码敲出来

兄弟们,今天咱来搞点好玩的——用CSS整一个3D轮播图!咱野生程序员就是要在代码里找乐子,技术和快乐咱都得要!代码是写不完的,但咱能自己敲出快乐来,走起!一、先整个容器,搭个舞台咋先写一个...

实现一个超酷的 3D 立体卡片效 #前端开发

今天我们来实现一个超酷的3D立体卡片效果。正常情况下就是一个普通的图片展示卡片,鼠标悬停的时候图片会跳出卡片,并将影子投射到背景卡片上,在视觉上有一个3D立体感。html主要分成3个部分:容器→背景层...

Vue 3 Teleport与Suspense:解决UI难题的两个&quot;隐藏大招&quot;

模态框的"层级噩梦"与Teleport的救赎"这个模态框怎么又被父容器截断了?"团队协作开发后台系统时,小张第N次遇到这个问题。多层嵌套的组件结构里,弹窗被overfl...

让交互更加生动!有意思的鼠标跟随 3D 旋转动效

今天,群友问了这样一个问题,如下所示的鼠标跟随交互效果,如何实现:简单分析一下,这个交互效果主要有两个核心:借助了CSS3D的能力元素的旋转需要和鼠标的移动相结合本文,就将讲述如何使用纯CSS...

填坑:transform元素导致zindex失效终极方法

今天遇到了使用css3动画的元素层级被放大置顶的问题,ios浏览器上没问题,安卓原生浏览器和安卓微信上有问题。使用了css3动画的元素z-index失效,兄弟元素设置多高的z-index都盖不住解决办...

诡异的层级错乱:一个被transform隐藏的CSS陷阱

周五下午三点十七分,设计部突然发来紧急截图——原本应该悬浮在顶部的导航菜单,此刻正诡异地被下方的轮播图遮挡。我盯着屏幕上错乱的层级关系,手指下意识地敲下z-index:9999,心里清楚这不过是程序...

动画篇--碎片动画

本文授权转载,作者:Sindri的小巢(简书)前言从最开始动笔动画篇的博客,至今已经过去了四个多月。这段时间回头看了看自己之前的动画文章,发现用来讲解动画的例子确实不那么的赏心悦目。于是这段时间总是想...

Nature:大洋转换断层处的拉张构造与两阶段地壳增生

Nature:大洋转换断层处的拉张构造与两阶段地壳增生转换断层是三种基本的板块边界之一,全球总长度超过48000km(Bird,2003),它们的发现为板块构造理论的建立奠定了重要的基础(Wil...