zoukankan      html  css  js  c++  java
  • 第五周作业-Markdown的使用心得

      在个人项目的时候,是我第一次接触到Markdown,也是在老师的提议下我们才会使用到Markdown的。当时个人项目的说明文档,只用到了一些简单的语法。而这次需求说明书的编写,由于内容更多更复杂,使我对Markdown的学习也有了更深的心得。

      首先简单地说下我对Markdown的认识。Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。用户可以使用诸如 * # 等简单的标记符号以最小的输入代价生成极富表现力的文档。

      Markdown具有很多优点:

    • 写作中添加简单符号即完成排版,所见即所得。让你专注于文字而不是排版。
    • 格式转换方便,Markdown 的文本你可以轻松转换为 html、pdf等。
    • 可以保存称纯文本。

      支持Markdown的编辑器太多,功能也不完全一致,有的是用来进行基本的写作,有的是用来写代码的,有的甚至只是博客平台配套的编辑器。国内至少有50家新的博客网站,都是以自定义、Markdown、简约、干净大方的特点出现的,而且一般都有自己定制的Markdown编辑器(网页版的或者离线版的,farbox就是离线版的)。而且因为Markdown语法支持编程语法高亮显示,这使得几乎所有的使用Markdown的博客网站都以“这里是给程序员准备的”为宣传语。密集的程序员社区更是数不胜数,有些是支持Markdown的,有些是支持LaTeX的。或者说国内网站的论坛、博客、社区,比较优秀的,开源的,不收费的,这样的地方,基本上都被程序员们占领了。

      在这个过程中我所使用的是“小书匠”和“MarkdownPad2”这两个编辑器。刚开始的时候我只是在“小书匠”上面编写,后来发现上传至coding上面的效果和“小书匠”的预览效果并不相同,如,“[TOC]”可以生成目录,而在coding的网页上并不可以,还有换行上面也不一致……

      关于Markdown语法的介绍,网络上还是挺多的。也就是说我如果要查一个我不太熟悉的编程语言的使用方法,原来我可能会去CSDN,而现在我只要百度一下,就会出现各种博客、社区、论坛在大规模讨论这些编程问题,都是展示自己的开源程序,各种命令行,各种高亮显示。下面我贴出来一些我使用到的语法:

    1. 标题设置(让字体变大,和word的标题意思一样)
    在Markdown当中设置标题,有两种方式:
    第一种:通过在文字下方添加“=”和“-”,他们分别表示一级标题和二级标题。
    第二种:在文字开头加上 “#”,通过“#”数量表示几级标题。(一共只有1~6级标题,1级标题字体最大)


    2. 块注释(blockquote)
    通过在文字开头添加“>”表示块注释。(当>和文字之间添加五个blank时,块注释的文字会有变化。)

    3. 斜体
    将需要设置为斜体的文字两端使用1个“*”或者“_”夹起来

    4. 粗体
    将需要设置为斜体的文字两端使用2个“*”或者“_”夹起来

    5. 无序列表
    在文字开头添加(*+, and -)实现无序列表。但是要注意在(*+, and -)和文字之间需要添加空格。(建议:一个文档中只是用一种无序列表的表示方式)

    6. 有序列表
    使用数字后面跟上句号。(还要有空格)

    7. 链接(Links)
    Markdown中有两种方式,实现链接,分别为内联方式和引用方式。

    内联方式:This is an [example link](http://example.com/).
    引用方式:

    I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].

    [1]: http://google.com/ "Google"
    [2]: http://search.yahoo.com/ "Yahoo Search"
    [3]: http://search.msn.com/ "MSN Search"

    8. 图片(Images)
    图片的处理方式和链接的处理方式,非常的类似。
    内联方式:![alt text](/path/to/img.jpg "Title")
    引用方式:

    ![alt text][id] 

    [id]: /path/to/img.jpg "Title"

    9. 代码(HTML中所谓的Code)
    实现方式有两种:
    第一种:简单文字出现一个代码框。使用`<blockquote>`。(`不是单引号而是左上角的ESC下面~中的`)
    第二种:大片文字需要实现代码框。使用Tab和四个空格。

    10. 脚注(footnote)
    实现方式如下:
    hello[^hello]
    [^hello]: hi

    11. 下划线
    在空白行下方添加三条“-”横线。(前面讲过在文字下方添加“-”,实现的2级标题)

  • 相关阅读:
    stm32f103和stm32f407的GPIO口模式设置以及相互对应的关系
    基于STM32单片机实现屏幕休眠后OLED屏幕滚动效果
    基于51单片机的超声波模块HC-SR04的使用
    用51单片机控制L298N电机驱动模块
    学习笔记——51单片机 单片机与单片机之间的通讯
    基于51单片机的电子密码锁—1
    LCD1602学习调试
    基于51单片机,通过定时器实现的时钟程序
    有进度条圆周率计算
    python turtle 学习笔记
  • 原文地址:https://www.cnblogs.com/LH956574963/p/5352855.html
Copyright © 2011-2022 走看看