您的位置: 首页  >  文章  >  Markdown快速入门

Markdown快速入门

分类: 文章 • 2022-10-26 08:57:08

以下内容转自-极客之星博客（www.geekerstar.com）

Markdown快速入门
Markdown 是一种可以使用普通文本编辑器编写的标记语言，语法简洁明了、学习容易，而且功能比纯文本更强。使用了markdown编辑器后，敲文字和敲代码一样，根本不需要用鼠标了，以下是我总结的一些markdown的使用规则。

1 MarkDown常用语法

1.1 标题

标题能显示出文章的结构，行首插入1-6个“#”，没增加一个#表示更升入层次的内容，对应到标题的深度由1-6阶。

  • H1 : #
  • H2 : ##
  • H3 : ###
  • H4 : ####
  • H5 : #####
  • H6 : ######

1.2 文本样式

  • 加粗 : **加粗内容**

  • 斜体字 : *斜体内容*

  • 删除线 : 删除内容

  • 列表 : * + - 添加星号(加号、减号)成为一个新的列表项，使用1. 2. 3.表示有序列表，使用*,-,+表示无序列表，无序列表或有序列表标记和后面的文字之间要有一个空格隔开，无序列表的项目符号按照实心圆，空心圆，实心放个的层级关系递进的。

  • 引用 : > 引用内容，>>表示嵌套引用，如果>和>>嵌套使用的话，从>>退到>时，必须要加一个空格或者>作为过渡

  • 内嵌代码 : 代码块 使用Esc下面那个键的英文半角前后包裹代码块

  • 画水平线 (HR) : ---

效果示例：

加粗

斜体

~删除线~

  • 添加星号（加号、减号）成为一个新的列表项
    1. 第一点
    2. 第二点
    3. 第三点
  • 第一级
    • 第二级
    • 第二级
    • 第二级
      • 第三级
      • 第三级
  • 哈哈

引用内容
二级引用

内嵌代码：alert('Hello World');

1.3 链接

行内形式（title可选）：
* this is an [example link](http://example.com/).

效果示例：

this is an example link.

如果一句话有多个链接，可以这样写
* 我喜欢[百度][1]，[阿里][2]和[腾讯][3]。
[1]: http://baidu.com/ "百度"
[2]: http://taobao.com/ "阿里"
[3]: http://qq.com/ "腾讯"

效果示例：

我喜欢百度，阿里和腾讯。

1.4 图片

图片的语法和链接很相似，其中text为图片失效后替换文字，title为鼠标放在图片上显示的文字：
* ![alt text](图片路径.jpg "title")

效果示例：

Markdown快速入门

1.5 表格

:---为左对齐，---:为右对齐，:---:为居中对齐：
* |左对齐|右对齐|居中对齐|
* |:----|-----:|:-----:|
* |左对齐|右对齐|居中对齐|
* |左对齐|右对齐|居中对齐|
* |左对齐|右对齐|居中对齐|

效果示例：

左对齐 右对齐 居中对齐
左对齐 右对齐 居中对齐
左对齐 右对齐 居中对齐
左对齐 右对齐 居中对齐

1.6 代码块

很多时候都需要贴上代码块，只需要```后面加上语言，如javascript即可。
* ```javascript
* 这里是代码块
* ```

效果示例：
php
function showThumbnail($widget){
$num = rand(1, 3);
switch($num){
case 1: $image_file = "";
break;
case 2: $image_file = "";
break;
case 3: $image_file = "";
break;
}
echo $image_file;
}

2 MarkDown进阶语法

待完善……

3 推荐工具及参考

3.1 推荐工具

[1]在线转换MD表格
[2]HTML转markdown

3.2 参考资料

[1]MarkDown语法说明完整版
[2]MarkDown语法说明简要版

以上内容转自本人博客-极客之星

相关推荐