Markdown使用小结

Posted gaozhidao

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Markdown使用小结相关的知识,希望对你有一定的参考价值。

Markdown 学习

本文旨在记录学习使用markdown 语法的过程中学习到的知识点

1. 基本介绍

1.1 Markdown 说明

  • Markdown 是一种轻量的标记语言
  • 旨在关注书写的内容,而不用花费大量的时间去排版
  • 目前很多站点支持此格式,如 github
  • 语法简单,易学易用
  • 推荐使用的Markdown编辑器 -- Typora (轻量级,功能尽可能的简单)

1.2 基本语法

1.2.1 标题

? 标题使用"#" 号来标记,类似于html 语言中的 h1 到 h6, 具体说明如下:

  • # 文字 类似于 HTML 中的H1
  • ## 文字 类似于 HTML 中的H2
  • 依次类推

1.2.2 分级标题

注意: = - 最少可以只写一个,兼容性一般
一级标题
====
二级标题
-------

1.2.3 生成目录

使用[TOC] 生成目录。

1.2.4 引用

使用符号(>)标记,可以进行单行或多行引用,说明如下:

这是一段多行引用说明
这是一段多行引用说明

1.2.5 行内标记

  • 用 `xxx` 标记代码块将变成一行
    示例如下:你好,Markdown

1.2.6 代码块

  • 使用```xxx``` 标记。示例如下:
<div>
    <div>hello world</div>
</div>
  • 使用 tab或四个空格 缩进。示例如下:

    hello world

1.2.7 段落

段落的换行是 使用两个以上空格加上回车

1.2.8 分割符

最少三个 --- 或 ***或 * * *

1.2.9 删除线

在文字的两端加上两个波浪线~~ 即可
示例: 删除内容

1.2.10 下划线

下划线通过HTML 的<u> 标记实现
示例: 下划线内容

1.2.11 列表

  • 无序列表

    无序列表使用 * , - , + 等符号标记,符号后需加空格

  • 有序列表

    有序列表使用数字标记, 如 1,2,3 等,数字后加., 保持空格

1.2.12 加粗、斜体

  • 加粗

    加粗使用 ** 号标记, 案例如下:

    这是一段加粗的文本

  • 斜体

    斜体使用* 号标记,案例如下:

    这是一段斜体文字

1.2.13 任务列表

  • 使用- [x] 选项一 表示。

1.2.14 插入链接

? 链接使用 [链接文字](链接地址) 来标记,案例如下:

? GOOGLE 首页
? 百度

1.2.15 插入图片

? 插入图片标记和插入链接类似,使用 ![]() 来标记,案例如下:

技术图片

1.2.16 插入视频

Markdown 语法是不支持直接插入视频的
普遍的一种做法是 插入HTML的 iframe 框架,通过网站自带的分享功能获取
第二是伪造播放界面,实质是插入视频图片,然后通过点击跳转到相关页面
示例如下:

<iframe height=498 width=510 src='http://player.youku.com/embed/XMjgzNzM0NTYxNg==' frameborder=0 'allowfullscreen'></iframe>

1.2.17 表格

: 代表对齐方式 ,: 与 | 之间不要有空格,否则对齐会有些不兼容。示例如下:

|    a    |       b       |      c     |
|:-------:|:------------- | ----------:|
|   居中  |     左对齐    |   右对齐   |
|=========|===============|============|
a b c
居中 左对齐 右对齐
========= =============== ============

1.2.18 支持内嵌CSS 样式

示例如下:

<p style="color: #AD5D0F;font-size: 30px; font-family: '宋体';">内联样式</p>

内联样式

1.2.19 公式{#1}

1个$左对齐,2个居中
示例如下:

$$ x href{why-equal.html}{=} y^2 + 1 $$
$ x = {-b pm sqrt{b^2-4ac} over 2a}. $

$ x href{why-equal.html}{=} y^2 + 1 $
$ x = {-b pm sqrt{b^2-4ac} over 2a}. $

1.2.20 脚注

Markdown[^1]
[^1]: Markdown是一种纯文本标记语言        // 在文章最后面显示脚注

Markdown[^1]
[^1]: Markdown是一种纯文本标记语言 // 在文章最后面显示脚注

1.2.21 锚点

只有标题支持锚点, 跳转目录方括号后 保持空格

[公式标题锚点](#1)

### [需要跳转的目录] {#1}    // 方括号后保持空格

示例如下:
公式标题锚点

[需要跳转的目录] {#1} // 方括号后保持空格

1.2.22 自动邮箱链接

<xxx@outlook.com>

xxx@outlook.com

1.2.23 流程图

flow                     // 流程  
st=>start: 开始|past:> http://www.baidu.com // 开始  
e=>end: 结束              // 结束  
c1=>condition: 条件1:>http://www.baidu.com[_parent]   // 判断条件  
c2=>condition: 条件2      // 判断条件  
c3=>condition: 条件3      // 判断条件  
io=>inputoutput: 输出     // 输出  
//----------------以上为定义参数-------------------------  
//----------------以下为连接参数-------------------------  
// 开始->判断条件1为no->判断条件2为no->判断条件3为no->输出->结束  
st->c1(yes,right)->c2(yes,right)->c3(yes,right)->io->e  
c1(no)->e                   // 条件1不满足->结束  
c2(no)->e                   // 条件2不满足->结束  
c3(no)->e                   // 条件3不满足->结束  

示例:
```flow // 流程
st=>start: 开始|past:> http://www.baidu.com // 开始
e=>end: 结束 // 结束
c1=>condition: 条件1:>http://www.baidu.com[_parent] // 判断条件
c2=>condition: 条件2 // 判断条件
c3=>condition: 条件3 // 判断条件
io=>inputoutput: 输出 // 输出
//----------------以上为定义参数-------------------------

//----------------以下为连接参数-------------------------
// 开始->判断条件1为no->判断条件2为no->判断条件3为no->输出->结束
st->c1(yes,right)->c2(yes,right)->c3(yes,right)->io->e
c1(no)->e // 条件1不满足->结束
c2(no)->e // 条件2不满足->结束
c3(no)->e // 条件3不满足->结束
```
____
其他关于 图形的描述,参考互联网上的资料。
runoob.com
简书博客

以上是关于Markdown使用小结的主要内容,如果未能解决你的问题,请参考以下文章

VS Code配置markdown代码片段

VS Code配置markdown代码片段

markdown 语法小结

markdown PHPExcel Notes和代码片段

markdown Git代码片段

markdown 岩组代码片段