学习Markdown

学习markdown

一、概述说明

  Markdown  是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。[1]
  目前markdown可以在多种网站上进行交互,例如cnblog、cdsn、github,这些网站都支持  markdown  格式。所以有其学习的必要性。
  本文基于博客园展示效果来简述markdown的一些语法及其使用。

二、编辑器选择

  为了更好的书写markdown格式的纯文本,本文推荐 widonws 平台下使用软件 markdownpad,下载地址:https://markdownpad.com/download.html。安装后可能遇到错误提示“HTML Render Error”,可通过安装插件 awesomium 来修复。[2]

三、语法介绍

  语法糖:当一些格式无法实现时请借助 html 标签,基本可以搞定。

1、标题格式

  标题格式是通过 "#"+空格 实现的。
  一级标题: "#  一级标题  #" (两个空格)
  一级标题: "##  二级标题  ##" (两个空格)
  一级标题: "###  三级标题  ###" (两个空格)
  当然,如果使用  MarkdownPad  编辑器,工具栏有内置的 H1 和 H2。

2、段落格式

  段落换行

  a、行尾添加两个以上空格加换行符实现。
  b、用一个空行简单的将两段落隔开。
  c、可以借助"<p></p>"标签实现。

  段落缩进

  段落缩进借助 html 标签实现
  a、&emsp;来表示一个全角空格;
  b、&ensp;表示一个半角空格。
  c、&nbsp;表示行中间的空格。

3、字体格式

  a、斜体文本,*斜体文本*:斜体文本
  b、粗体文本,**粗体文本**:粗体文本;
  c、粗斜体文本,***粗斜体文本***:粗斜体文本;
  d、分割线,一行中用三个以上的星号、减号、底线来建立一个分隔线:


  e、删除线,用s标签实现 <s>删除线</s>:删除线
  f、文本居中,<center>居中文本</center>:

居中文本

    注意,在使用center后的文本独占一行。
  g、脚注,首先要定义脚注: "[^LABEL]: ",在引用处使用[^LABEL]即可。上文中的[1]、[2]都是以此方法实现。

4、插入图片

  a.借助 Markdown 提供的 alt 标签实现:![alt 属性文本](图片地址 "可选标题") 可选标题项可省略。
  b.借助 html 提供的 <img> 标签实现: <img src="图片地址"></img>,可以添加 img 标签支持的样式及属性。
  c.借助 html 提供的 <img> 标签和 <div> 标签实现图片居中。本文章节二中就是如此实现。

5、插入代码块

  a.行内插入某个函数或这一行代码,用"`"括起来即可。`printf()`: printf()
  b.一整块代码,可以在每行代码前加4个空格或1个tab。注意:起止行要与其他部分加空行隔开

	#!/usr/bin/python  
	# -*- coding: utf-8 -*-  


	def main():
    	print('hello world')

	main()

5、插入表格

  在Markdown中,用 | 分割前后单元格,用-来分隔表头行和其他行。

<div class="center">  
|表头|表头|表头|  
|---|---|---|  
|内瓤|内容|内容|  
</div>  

显示效果如下:

表头 表头 表头
内瓤 内容 内容

  在分割表头行和数据行时可以用 :--- 表示左对齐; :---:表示居中对齐; ---: 表示右对齐。
  如果要实现整个表格的居中,可以在文档开头定义类选择器,设置好居中格式,然后将表格写入 div 标签,并为标签设置class属性。本文开头有全局的style,并且为表格设置了格式。此方法对于所有不可实现的格式都可用。甚至表格本身都可以用 table 标签实现。

<style>.center {
  width: auto;
  display: table;
  margin-left: auto;
  margin-right: auto;
}
</style>

6、插入区块

  笔者理解这里的区块就类似文章标题的缩进,可以用">"加空格实现。

\> 1、概述说明  
\> 2、编辑器选择
\> 3、语法介绍  
\>  
\> \> 3.1、标题格式  
\> \> 3.2、段落格式  

显示效果如下:

1、概述说明
2、编辑器选择
3、语法介绍

3.1、标题格式
3.2、段落格式

4、本篇博客效果

6、插入列表

  无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记。
  有序列表使用数字并加上 . 号来表示。

<div class="center">
* 星期一
* 星期二
* 星期三

1. 第一行
2. 第二行
3. 第三行
</div>

  显示效果:

  • 星期一
  • 星期二
  • 星期三
  1. 第一行
  2. 第二行
  3. 第三行

四、本篇博客效果

  本文的文本效果可以参考博客园https://www.cnblogs.com/mengrui291/p/12807050.html
  文本文档全内容可以参考(待发布git之后补充链接)

五、注意事项

  如果使用了

六、参考资料


  1. https://baike.baidu.com/item/markdown/3245829?fr=aladdin ↩︎

  2. https://blog.csdn.net/Z1272633296/article/details/104613743 ↩︎

猜你喜欢

转载自www.cnblogs.com/mengrui291/p/12807050.html
今日推荐