MarkDown详细入门笔记

news2024/12/25 23:51:04

本帖整理了MarkDown的入门学习笔记~


一.介绍

Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。

诸如微信公众平台、CSDN博客、还有Typora中写文档的部分,均涉及到MD的功能~

它用简洁的语法代替排版,而不像一般我们用的字处理软件 Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字,用「标记」语法,来代替常见的排版格式。例如此文从内容到格式,甚至插图,键盘就可以通通搞定了。

支持 Markdown 语法的编辑器有很多,Markdown 从写作到完成,导出格式随心所欲,你可以导出 HTML 格式的文件用来网站发布,也可以十分方便的导出 PDF 格式

使用 Markdown 的优点

  • 专注你的文字内容而不是排版样式,安心写作
  • 轻松的导出 HTML、PDF 和本身的 .md 文件
  • 纯文本内容,兼容所有的文本编辑器与字处理软件
  • 随时修改你的文章版本,不必像字处理软件生成若干文件版本导致混乱
  • 可读、直观、学习成本低

Markdown 旨在简洁、高效,也由于 Markdown 的易读易写,人们用不同的编程语言实现了多个版本的解析器和生成器。这就导致了目前不同的 Markdown 工具集成了不同的功能(基础功能大致相同),例如流程图与时序图,复杂表格与复杂公式的呈现,比如 GFM Markdown 就支持使用 Mermaid 生成图表和流程图。

二.段落及强调

在 Markdown 中,段落是由一个以上相连接的行句组成,而一个以上的空行则会切分出不同的段落,一般的段落不需要用空白或换行缩排。(空行的定义是显示上看起来像是空行,便会被视为空行。比如,若某一行只包含空白和 tab,则该行也会被视为空行)

Markdown 允许段落内的强迫换行,这个特性和其他大部分的 text-to-HTML 格式不一样,其它的格式会把每个换行都转成 <br /> 标签。

这也就意味着在 Markdown 中,如果需要把一段内容当做段落来显示,则需要保证该段内容上方及下方至少各有一个空行~

如下是MD中字体的几种特殊样式语法:

  • 强调:Markdown 使用星号 * 和下划线 - 作为标记强调字词的符号。
  • 斜体:在 Markdown 中,将内容用 * 或 _ 包裹起来

(用什么符号开启标签,就要用什么符号结束;* 和 _ 两边都有空白的话,它们就只会被当成普通的符号)

  • 粗体:用两个 * 或 _ 包起来
  • 删除线:你还可以使用两个 ~ 来给内容加上~~删除线~~

三.标题

Markdown 支持两种标题的语法,Setext 和 atx 形式。

  • Setext 形式标题:Setext 形式是用底线的形式,利用 = (一级标题)和 - (二级标题)
  • Atx 形式标题:Atx 形式则是在行首插入 1 到 6 个 #(最多支持 6 级标题) ,对应到标题 1 到 6 级

四.链接

Markdown 支持两种形式的链接语法:行内和参考两种形式。不管是哪一种,链接的文字都是用 [方括号] 来标记。

  • 行内形式链接:行内形式的链接是在方块括号后面接括号并插入网址链接即可,如果你还想要加上链接的 alt 提示文字,只要在网址后面,用双引号把 alt 文字包起来即可,其格式为 [内容](http_url "alt 提示")
  • 参考形式链接:参考形式的链接使用另外一个方括号接在链接文字的括号后面,而在第二个方括号里面要填入用以辨识链接的标签

(注意:在MD可以使用Html的多数标签)

五.图片

Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内和参考

  • 行内形式图片:行内形式图片的语法格式为![Alt text](/path/to/img.jpg "Optional title")
  • 参考样式图片:的格式添加一个图片,其结构为 ![内容][1] + [1]: image_url "alt 提示" 的组合

六.列表

  • 无序列表:无序列表使用 * 、 + 或是 - 作为列表标记
  • 有序列表:有序列表则使用数字接着一个英文句号
  • 任务列表:任务列表的语法格式为 - [ ] todo,其中 [ ] (带空格的中括号)表示未完成的任务,[x](带字母x的中括号) 表示已经完成的任务

七.分隔线及引用

你可以在一行中用三个或以上的*-_来创建一个分隔线,行内不能有其他东西。你也可以在星号中间插入空白。

 

引用:Markdown 使用 email 形式的区块引用,我们在要引用内容每行的最前面加上 > ,就可以在 Markdown 文档中创建一个区块引用

八.代码块

行内代码的格式很简单,只需要使用两个 ` 将代码内容包裹起来即可,还有其他几种表达方式:

  • 用两个 ` 将代码内容包裹起来就是一个行内代码
  • 缩进 4 个空白或是 1 个 tab 可以创建一个缩进代码块
  • 在代码块的前后各使用三个反引号( ``` )把需要高亮显示的代码包裹起来,并在第一个 ``` 的末尾标识上语言类型就可以创建一个高亮代码块

九.表格 

在 Markdown 中创建表格的语法要求如下:

  1. 第一行包含表头,并用"竖线"( | )分隔
  2. 第二行将标题与单元格分开,并且必须包含三个或更多破折号
  3. 第三行以及随后的任何行均包含单元格值

需要注意的是:

  • 不能在 Markdown 中将单元格分隔成多行,它们必须保持为单行,如果需要,还可以使用 HTML <br>标记对内容进行强制换行
  • 第二行单元长短与标题不需要保持一致,但必须用竖线(|)分隔
  • 可以有空白的单元格

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/1138544.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

【rust/esp32】wsl2开发环境搭建与测试

文章目录 说在前面流程可能的问题wsl2相关rust相关vscode相关build相关 测试吐槽参考 说在前面 esp型号&#xff1a;esp32s3开发环境&#xff1a;wsl2rustc版本&#xff1a;rustc 1.73.0-nightlyesp idf版本&#xff1a;v5.1.1 流程 目前是按照这个demo的流程可以跑通修改demo…

【spark客户端】Spark SQL CLI详解:怎么执行sql文件、注释怎么写,支持的文件路径协议、交互式模式使用细节

文章目录 一. Spark SQL Command Line Options(命令行参数)二. The hiverc File1. without the -i2. .hiverc 介绍 三. 支持的路径协议四. 支持的注释类型五. Spark SQL CLI交互式命令六. Examples1. running a query from the command line2. setting Hive configuration vari…

influxdb基本使用及其源码解析

文章目录 基本介绍简介属性特点场景 相关概念seriesseries cardinalityShardShard groupShard DurationRetention policyTSMLSM 源码解析编译IDE调试服务启动metaShardShard groupRetentionPolicyDatabaseInfo Data数据写入SeriesIndexInmem Indextsi index StoreShardEngineTS…

【Javascript】函数之形参与实参

function c(a,b){return ab;}var sumc(3,4);console.log(sum);a,b为形参 3,4为实参 形参和实参是⼀⼀对应的数量可以不对应参数的类型不确定函数可以设置默认参数实参可以是字⾯量也可以是变量

规则推理桌游

目录 Eleusis Express 1&#xff0c;规则 2&#xff0c;出牌规则示例 3&#xff0c;中文规则 Eleusis Express 原文&#xff1a;Eleusis Express 1&#xff0c;规则 简单来说就是需要一个主持人想一个出牌规则&#xff0c;其他人通过出牌试探过程推理出这个出牌规则。 …

python:使用Flask-SQLAlchemy对数据库增删改查的简单示例

以下将介绍Flask-SQLAlchemy对数据库增删改查的简单示例。 一、安装所需的库 pip install flask flask-sqlalchemy flask-mysql 二、创建数据表 本示例使用mysql创建数据库和表 CREATE TABLE user ( id int(11) NOT NULL AUTO_INCREMENT, name varchar(255) DEFAULT NULL…

数据结构与算法-二叉树的遍历

&#x1f31e; “少年没有乌托邦&#xff0c;心向远方自明朗&#xff01;” 二叉树 &#x1f388;1.二叉树的遍历&#x1f52d;1.1先序遍历&#x1f52d;1.2中序遍历&#x1f52d;1.3后序遍历&#x1f52d;1.4层次遍历&#x1f52d;1.5二叉树遍历的递归算法&#x1f4dd;1.5.1先…

centos部署tomcat

Java Downloads | Oracle

mq的使用方法

mq的使用方法 1、先写好自己的业务以及只会需要mq异步调用的业务 2、在先前的业务中发送mq消息 mqProducer.syncSend(ActivityRedisConstant.TOPIC_SAVE_SIGNUP, saveSignUpMsg); 3、设定好mq的topic消息主题 Value(“${mq.signup-topic:saas-signup}”)从nacos中取如果没…

java代码审计-换行符CRLF注入

CRLF 的缩写是指回车和换行操作&#xff0c;其中 CR 为 ASCII 中的第 13 个字符&#xff0c;也 写作 \r , LF 是 ASCII 中的第 10 个字符&#xff0c;也写作 \n &#xff0c;因此 CRLF 一般翻译为回车换行注入漏洞。 什么是CRLF注入漏洞? CRLF 即【回车\r换行\n】的简…

Centos安装RabbitMQ,JavaSpring发送RabbitMQ延迟延时消息,JavaSpring消费RabbitMQ消息

1&#xff0c;版本说明 erlang 和 rabbitmq 版本说明 https://www.rabbitmq.com/which-erlang.html 确认需要安装的mq版本以及对应的erlang版本。 2&#xff0c;下载安装文件 RabbitMQ下载地址&#xff1a; https://packagecloud.io/rabbitmq/rabbitmq-server Erlang下载地…

在微信小程序云开发中引入Vant Weapp组件库

介绍 Vant 是一个轻量、可靠的移动端组件库&#xff0c;于 2017 年开源。 目前 Vant 官方提供了 Vue 2 版本、Vue 3 版本和微信小程序版本&#xff0c;并由社区团队维护 React 版本和支付宝小程序版本。 介绍 - Vant Weapp (youzan.github.io) Vant Weapp需要安装 node.js&…

nodejs+vue 电子书阅读系统

本文首先介绍了电子书阅读系统的发展背景与发展现状&#xff0c;然后遵循软件常规开发流程&#xff0c;首先针对系统选取适用的语言和开发平台&#xff0c;随着网络技术的不断发展&#xff0c;多媒体技术应用渐渐的出现在教育领域中&#xff0c;电子书阅读已经成为社会的一个热…

02-URL与资源

浏览​因特网资源 URI是一类更通用的资源标识符&#xff0c;URL与URN是它的子集URL通过描述资源的位置来标识资源HTTP规范将更通用的概念URI作为资源标识符&#xff0c;实际上&#xff0c;HTTP应用程序处理的知识URI的URL子集URL可以通过HTTP之外的其他协议来访问资源。 http链…

Unity C#中LuaTable、LuaArrayTable、LuaDictTable中数据的增删改查

LuaTable、LuaArrayTable、LuaDictTable中数据的增删改查 介绍Lua表lua表初始化lua移除引用lua中向表中添加数据lua中表中移除数据lua表中连接数据lua表中数据排序获取lua表长度获取表中最大值 UnityC#中LuaTableUnityC#中LuaArrayTable、LuaDictTable、LuaDictTable<K,V>…

HTTP发起请求与收到响应的大致过程

可以《《透视 HTTP 协议》Windows 10 搭建最小实验环境》搭建环境&#xff0c;之后才能进行下边的操作。 1.鼠标左键点击两下www目录下的start.bat批处理文件。 2.打开Wireshark&#xff0c;然后选择Adapter for loopback traffic capture。 3.然后把tcp.port 80 || udp.…

基于Springboot自习预约管理系统

功能介绍&#xff1a; 基于Springboot自习预约管理系统。该系统为后台管理系统&#xff0c;无前台。主要角色有&#xff1a;管理员和学生。 主要功能&#xff1a; 学生信息管理&#xff1a;学号、姓名、专业、班级、年级、联系方式 教室信息管理&#xff1a;教室、教室号、楼…

el-form那些事

vue3element-plus el-form那些事 输入框后拼接文字 输入框后拼接文字 <el-form-item :label"t(location.locationLength)" prop"locationLength"><el-input v-model"form.locationLength" :placeholder"t(location.inputLocation…

深度学习中语义分割、实例分割、目标检测和图像分类区别

语义分割 实例分割 目标检测 语义分割&#xff1a;需要判断每个像素属于哪一个类别&#xff0c;属于像素级别分类标注 实例分割&#xff1a;相较于语义分割 会将同一类别的不同物体进行分离标注 目标检测&#xff1a;输入图像通常包含多个物体&#xff0c;对物体的位置与类别进…

C# 图解教程 第5版 —— 第9章 表达式和运算符

文章目录 9.1 表达式&#xff08;*&#xff09;9.2 字面量9.2.1 整数字面量9.2.2 实数字面量9.2.3 字符字面量9.2.4 字符串字面量 9.3 求值顺序9.3.1 优先级9.3.2 结合性 9.4 简单算术运算符9.5 求余运算符9.6 关系比较运算符和相等比较运算符9.7 递增运算符和递减运算符&#…