首页 > 其他 > 详细

学习Markdown

时间:2020-04-30 16:04:11      阅读:46      评论:0      收藏:0      [点我收藏+]

学习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 ??

学习Markdown

原文:https://www.cnblogs.com/mengrui291/p/12807050.html

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!