Markdown 使用教程

前言

　　以前经常在 github 中看到 .md 格式的文件，一直没有注意，也不明白为什么文本文档的后缀不是 .txt ,后来无意中看到了 Markdown，看到了用这个东西写得一些web界面等特别的规整漂亮，顿时不明觉厉。后来自己学习了一下，感觉这个语言确实简洁、美观，现推荐出来供大家学习和玩玩，希望能对你有用。

　　本文图文并茂，避免了单纯看语法的枯燥和繁琐，其实，学习一门新东西真的其乐无穷！

简介　　

Markdown 是一种用来文本处理的轻量级 「标记语言」，它用简洁的语法代替排版，而无需像Microsoft的Word一样需要花费大量的时间进行排版、字体设置。它使我们专心于码字，用「标记」语法，来代替常见的排版格式。Markdown不止可以处理文本，使得文字更美观，还支持图像、表格等的插入，大大方便了我们的写作。例如此文从内容到格式，甚至插图，一个键盘可以搞定了，无需鼠标！

　　目前来看，支持 Markdown 语法的编辑器有很多，包括很多网站（例如简书）也支持了 Markdown 的文字录入。Markdown 从写作到完成，导出格式随心所欲，你可以导出 HTML 格式的文件用来网站发布，也可以十分方便的导出 PDF 格式，甚至可以利用 CloudApp 这种云服务工具直接上传至网页用来分享你的文章，全球最大的轻博客平台 Tumblr，也支持 Mou 这类 Markdown 工具的直接上传。

　　目前，我们的 博客园 同样支持了Markdown文本的编辑，具体如何设置请往下看！

Markdown特点

  • 专注你的文字内容而不是排版样式；
  • 轻松的导出 HTML、PDF 和本身的 .md 文件；
  • 纯文本内容，兼容所有的文本编辑器与字处理软件；
  • 可读，直观。适合所有人的写作语言。

教程

简明教程：

详细教程

博客园配置Markdown编辑器

  1. 进入博客后台
  2. 点击“设置默认编辑器”
  3. 选中 Markdown并保存
  4. 回到随笔界面点击“添加随笔”
  5. 在“Markdown编辑器”中输入相应的代码

语法

1. 标题

标题通过 # 的个数来进行区分，Mardown总共支持6级标题。

2. 段落 & 换行

2.1. 首行缩进/空格:

  •  : 英文空格(半角)
  •  : 中文空格(全角)
  • 输入法切换至全角，双击 空格 「推荐」
  • 半方大的空白   或 &#8194
  • 全方大的空白  或 &#8195
  • 不断行的空白格   或 &#160

2.2. 强制换行

　　连续的字符串，如果你想要换行，往往打“Enter”是不管用的，正确的换行方法为在 「在需要换行的地方插入 >=2 个 空格」

2.3. 空行

两种方式：

  • 在markdown中加入 >=2 个空行.
  • 使用<br> 【推荐】
    　　

3. 列表

在Markdown下，有四种列表：有序和无序；

  • 有序列表：采用 1. 2. 3.的形式
  • 无序列表：采用前面加 * - + 的方式，支持多级嵌套
  • 未完成列表：- [ ]，每个符号间均有空格
  • 已完成列表：- [x]，注意空格使用
    PS: 符号与文字之间必须有 空格


4. 引用 (Quote)

若需要引入有出处的一段话等，可以采用引用的方式实现，实现方式为在行开始处加入>,如下所示：

5. 字体设置

  • 粗体：
    字符串前后均加上 **
  • 斜体
    字符串前后均加上 *
  • 删除线
    字符串前后各加 ~~
  • ++下划线++
    字符串前后各加 ++
  • == 字体背景色 ==
    字符串前后各加 ==
  • 标记
    字体前后加上 ` (Esc下方的那个键)

6. 分割带

当上下文不属于同一模块或者无甚关联时刻，可以使用分隔符进行隔开；分隔符的格式如下：

  • 连续多个-(>=3)
  • 连续多个*(>=3)
  • 连续多个下划线 _ (>=3)
  • PS：以上，分隔符中间可以有空格，但分割行不可有其它字符存在

7. 图片和链接

  • 图片
    ![]() : [图片名称] (图片网络地址)
  • 链接
    []() ： [链接名称(可自定义)] (链接地址)

8. 代码块

和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块，通常这些区块我们并不希望它以一般段落文件的方式去排版，而是照原来的样子显示，Markdown 会用制表符来将代码包起来。
代码块一直持续到没有缩进的那一行(或是文件的结尾)

    #include <iostrem>
    using namespace std;
    int main(int argc, char **argv)
    {
        cout << "hello,world!";
    }

9. 网址自动转换

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是<>包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样，例如：

这个是我的博客地址：https://home.cnblogs.com/u/Jimmy1988/
我的邮箱地址是：[email protected]

10. 转义

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果，你可以在星号的前面加上反斜杠：

*literal asterisks*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

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

11. 生成目录

  • 前提条件：

    标题的建立是采用MD格式实现的，目录的生成建议放在文本最开始部分（当然也可以嵌入在文中）。

  • 语法

    [TOC]，中间不要有空格

  • 注意事项

    目录的生成并不是每个编辑器都支持的，至今我用过的编辑器 有道云笔记是支持的。

12. 表格


表格的做法通常为：

header 1 | header 2
--- |---
row 1 col 1 | row 1 col 2
row 2 col 1 | row 2 col 2

可用`<br>进行单元格内换行； 但是暂时不支持合并单元格

工具推荐

windows平台

Linux平台

Mac平台

浏览器插件

在线编辑器

  • 麻花：支持在线编辑，关键支持VIM命令

高级应用

更多工具


原文地址：https://www.cnblogs.com/wushuaishuai/p/9248105.html

时间： 2024-10-11 05:11:16

Markdown 使用教程的相关文章

Markdown简明教程4-Markdown UML图

1. 前言 Markdown是一种轻量级的标记语言,把作者从繁杂的排版工作中解放出来,实现易读易写的文章写作,已经逐渐成为事实上的行业标准.CSDN博客支持Markdown可以让广大博友更加专注于博客内容,大赞.但是,不少博友可能对Markdown比较生疏,本博接下来用一个系列文章<Markdown简明教程>扼要介绍Markdown,希望可以对大家有所帮助. 系列教程目录 关于Markdown Markdown基本使用 Markdown表格和公式 Markdown UML图 CSDN Mark

《CSDN Markdown简明教程》课程上线！

0. 目录 目录 前言 课程详情 课程介绍 课程目标 课程目录 课程简介 快速上手1-文本格式化 快速上手2-代码格式化和列表 快速上手3-链接和图片 快速上手4-目录脚注和表格 公式编辑 UML图绘制-序列图 UML图绘制2-流程图 健步如飞 参考博文 等待您的建议 声明 1. 前言 为提高广大C友 Markdown水平,响应CSDN号召,本博录制<CSDN Markdown简明教程>专栏的配套视频教程,业已上线,请广大C友批评指正! 2. 课程详情 <CSDN Markdown简明教

Markdown简明教程5-CSDN Markdown快速上手

0.目录 目录 前言 CSDN Markdown特点 CSDN Markdown快速上手 1 使用快捷键 粗体斜体 引用 链接 高亮代码块 图片 标题 列表 分割线 撤销重复 2 使用离线写作 3 使用导入导出 4 个性定制文章模板 声明 1. 前言 Markdown是一种轻量级的标记语言,把作者从繁杂的排版工作中解放出来,实现易读易写的文章写作,已经逐渐成为事实上的行业标准.CSDN博客支持Markdown可以让广大博友更加专注于博客内容,大赞.但是,不少博友可能对Markdown比较生疏,本

Markdown新手教程

Markdown新手教程 什么是Markdown? Markdown是一种轻量级标记语言.它允许人们"使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档".Markdown 的设计目的是方便写作的时候,标记格式.同时使标记格式后的纯文本,比起 HTML 源码,更有可读性. 用Markdown写作有什么优缺点? 概括来讲,Markdown有如下优点: - 语法比HTML简单,并且能实现大部分HTML能实现的功能 - 格式排版良好,简单直观,可读性强 有哪些比

最完整的Markdown基础教程

最完整的Markdown基础教程 最完整的Markdown基础教程 最完整的Markdown基础教程 原文地址:https://www.cnblogs.com/fanlinglong/p/12298439.html

GitHub官方Markdown语法教程

说明:Markdown随着编译器不一样,语法也都不一样,但这份GitHub提供的官方教程,基本学会这份就够了. https://guides.github.com/features/mastering-markdown/ https://guides.github.com/pdfs/markdown-cheatsheet-online.pdf 原文地址:https://www.cnblogs.com/EasonJim/p/8463510.html

Markdown使用教程

什么是Markdown语言 Markdown是一门如同HTML一样的标记语言.它使用一些简单的标记来展现文档的不同格式,例如,本章节的标题我们就是使用这样的格式表示的: # 什么是Markdown语言 这个展现出来的就是本章的标题. 为什么使用Markdown语言 样式丰富 使用Markdown语言,可以使文档拥有丰富的展现形式,各种不同的格式,十分适用于博客,文档等使用场景. 简单易学 通过上一节的例子我们会发现,Markdown语言明显比其他标记语言,如HTML,简单易学.在HTML中写标题

Markdown 简明教程

基本介绍 Markdown是一种用来写作的轻量级标记语言. 用标记语法,来代替常见的排版格式. 兼容 HTML代码. 特殊字符自动转换,例如<和&. 字体效果 使用星号*和底号_表示em标签. 例如: *斜体* _斜体_ 效果: 斜体 使用双星号**和双底号__表示strong标签. 例如: **强调** __强调__ 效果: 强调 标题 生成h1,h6标签,是通过在文字前面加上同等个数#符号来实现. 出于美观,也可以使用对称的闭合式标题符号. 例如: ## 这是标题 ## 这是标题 ##

Markdown入门教程

Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用.看到这里请不要被「标记」.「语言」所迷惑,Markdown 的语法十分简单.常用的标记符号也不超过十个,这种相对于更为复杂的HTML 标记语言来说,Markdown 可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果. 认识 Markdown 在刚才的导语里提到,Markdown 是一种用来写作的轻量级「标记语言」,它用简洁的语法代替排版,而不像一般我们用的字