markdown-first_experience

重要的markdown语法

一、对于代码块

• 对于代码的引用，可以使用“>”进行逐行引用，如果单独使用此符号，则编译器会自动分配一个空行。

  Practice makes perfect !

  可以实现层层嵌套，即引用的段落中可以再接着引用其他的文章和内容。

• 还可以采用另一种方法，就是借助’’’ 这符号，来直接引用代码

  module key_test
  (
      input      sys_clk,
      input      rst_n,
      input[3:0] key_in,
      input[3:0] led
  );
  reg[3:0] led_r;
  reg[3:0] led_r1;
  always@(posedge sys_clk or negedge rst_n)
      begin
      if(~rst_n)
          led_r<= 4'b0000;
      else
          led_r<=~key_in;
      end
  always@(posedge sys_clk or negedge rst_n)
          begin
          if(~rst_n)
              led_r1 <= 4'b0000;
          else
              led_r1<=led_r;
           end 
  assign led= led_r1;
  endmodule
  

二、对于换行的操作

• 常见的换行的操作是直接使用回车进行换行，但是这种方式采用的方式是重新开始一个新的段落，会增大同一个段落间的距离。
• 还可以参考HTML的语法，采用
  进行回车换行操作，这种操作是重新开始一个新的行，而不是重新开始一个段落，所以使用它会使整个文章非常的紧凑。
  此处使用的是HTML中的《br》,将书名号换成大于号和小于号，就是上面介绍的第二种换行的方式。
• 还可以采用多于两个以上的空格来实现自动的换行操作（这个需要编译器进行支持，并不一定是所有的编译器都支持）。

三、对于超链接的使用

• 局部链接

  局部超链接适用于在文章中多次引用完全不同的文章，从而可以快速的进行文章的跳转，给读者提供了非常方便的阅读体验。而且事后，也可以方便作者对文献和文章的整理引用。

  • 格式： [超链接文本]（链接地址）

  • 例子：我们可以通过查阅谷歌浏览器来提升我们获取信息的渠道，毕竟它是全球最棒的浏览器和公司。

• 全文链接

  所谓全文链接，是在文章的特定位置建立集中的超链接文本目录，从而在全文的任意位置进行同一内容的重复引用。对于学习而言，适合对某一专业课程进行学习时，做特定的密集型的学习笔记。对于工作而言，可以对某一项目的开发全流程进行随时随地的标注。
  

  • 格式：
    [超链接文本][链接别名1]

    [超链接文本][链接2别名]

    [超链接文本][链接1别名]

​ 超链接文本块被集中的放在了文章的最后一部分，借助Typora可以清晰地看见这一部分内容。

​ 为了能更方便的可以使用全文链接，下面是举个栗子

• 在当今这个网络世界里，充满了太多获取信心的渠道，如果我们真的喜欢上网，那我们是可以随时随地获取很多自己感兴趣或者被动感兴趣的内容，而这也催生了一大批的网络商业帝国的崛起，这里举一个不恰当的例子，从国内来看，可能百度是国人专属的搜索引擎，但是放在世界这个人类共有社区，它只是一个群众基数被动提升的浏览器。而其他一些流行的浏览器中，微软的microsoft edge 最近也是越发的生猛，大有取代windows端浏览器的趋势。而这也恰恰反映了谷歌的伟大。

四、 对于图片的引用（本地和网络端）

其实对于图片的引用，和超链接的引用是类似的，我们可以直接使用本地或者网络上的图片进行文档的编辑，但是我个人更喜欢在本地进行图片的引用，特别要强调的一点是，如果想要长期保存文件，建议编辑完成的文档输出为PDF格式，避免目录更改，导致文档缺少图片，或者公式等

• 局部引用

​ 局部引用是该图片只在图片的周围进行引用，且引用的次数很少，不用担心重新填写引用路径过于繁琐。

• • 格式： 本质是在局部超链接的前面添加一个感叹号。
    

• 全文引用

  全文引用和超链接一样，如果一片博客中，需要多次重复引用同一幅图，那么可以借鉴这种方式，对复杂图片的多次解读，比如一个程序运行的流程框图，包含很多的跳转，那么对于逐步解释它的运行状态来说，多次引用这个图片，从创作者的角度来看，将显得非常的便利。

• • 格式（在超链接的基础上加上一个！即可，完成对图片的转变）

  ​

  ​

  ​

  ​ 图片链接块

  • 这样的操作，可以非常清楚地知道每一张图片的存储路径，方便编辑人员进行文档的梳理，特别是当文件越多越容易整理。
  • 如果在网上找到了一组自己喜欢的图片，可以将复制图片的图像链接，将其添加到图片链接块后，则博客中会直接调用网络上的资源。
  • 对于本地的图片资源，需要在完成编辑后，上传时，需要重新再原来插图的位置上，利用上传图片的方式，将本地的图，上传到对应博客的服务器上。

五、对于逐行引用

• 这个主题的开设其实和段落是有点相似的，可以单独用一个>来实现多段文章的引用。

• 或者也可以采用在引用段落部分，进行回车换行，来实现新的段落的引用。

  note：如果担心文章段落间的间距太大，可以用>进行逐行的引用，从而可以保障文章段落之间的间距只有一行

I think the world is very important points that we could improve our power to change the universe, because the human will support everything

The people always want to do their best .

方式二，进行逐行的引用，段落间距只有一行。

这个就是逐行引用的效果

这个是一个新行

六、添加列表

之所以介绍列表，是因为列表可以用于进行任务的规划和分解，特别适合进行一个项目的开发和分解，但是也要注意不能嵌套太多的层，否则，会干扰逻辑的梳理，算是画蛇添足！

• 无序列表

​ 所谓无序列表，就是只用一个点和缩进进行层级划分，而没有明确的数字标识，它的优点是非常的简洁。

• • 举例：

    • 对于FPGA学习规划

    • • 理论学习
        • 数字电路
        • 电路分析
        • Verilog语法
        • 常用的芯片手册（zynq芯片）
        • FPGA架构
    • • 实践操作
        • 编译软件
          • Vivado
          • Quartus 11
          • ISE
        • 仿真软件
          • modelsim
          • tinner
          • multisim
        • 下载驱动
          • 下载器的驱动程序
          • 串口的驱动程序
        • 上位机软件
          • 采集数据的在线分析

    ​

• 有序列表

  有序列表是可以对任务进行分步处理，从而更高效地完成任务，也有利于养成缜思考的习惯，特别是对FPGA的开发而言，这是尤其重要的一点，因为FPGA归根到底，要完成的是时序的控制，而时序控制的关键是对计数器形态的高度灵活应用（比如不同的数据编码，位宽，奇偶等）。

  • 举例：

    1. 本周的任务规划
       1. 学习VIVADO软件，特别是最近用的比较多的ZYNQ系列的芯片
       2. 整理AD软件的常用快捷操作
       3. 初步了解国产紫光同创的发展状况，甚至是FPGA的未来趋势和国内外发展现状，从而知晓未来的国产可替代性。
    2. 下周的任务安排
       1. 完成师兄的PCB布线任务
       2. 逐步了解实验室的PCB布线规则和VHDL or Verilog 的编写规则
       3. 自己尝试写一些代码，熟悉并行语言的魅力和testbench文件的编写

七、段落

熟悉不同段落的切换方式，可以更加高效的写出优秀的博客和笔记，虽然和上面的换行部分有重复，但为了加深印象，所以再提起一次吧。

• 傻瓜式操作： 直接回车就行了

• 码农习惯：可以借助
  来进行简单的换行，但是如果手动缩进两个字符，那么这便是直接缩短了两个段落间的间距了。所以很直观的可以看到这些明显的变化。

• 艺术范儿

  我们都有一个家

  字太多了，不知道能不能看到这里哈哈哈哈哈，我可真是天才，预测了这么多人的内心想法！！

八、 添加任务列表

我是太喜欢这个小功能了，因为我们每天都会有一个任务规划，而这个小玩意可以用来跟踪任务完成进度。

格式：- [x] xxxxx // 缺一不可，否则不能打印出这个小方框框呢！

例子：

• finally the change
• push my commits to github
• open a pull request

note:

1.在- 和 [x]中间必须有一个空格，否则不能正确地输入任务窗口。
2. 在[]中必须加入x才可
3.在完成任务罗列后，可以用鼠标点击方框框，来进行任务完成度的标记

九、 修改图片大小

俺今天没工夫写了，等以后有时间在去写哈！可能就是明天了。

十、添加公式

这个我是近期用不到，所以感兴趣的同学可以自行进行搜索，这个如果如果在这里使用，需要有点LATEX基础，而使用markdown是因为它是一个轻量级的编辑器，如果是重度的键盘王子，建议移步CTEX或者LATEX，进行自行学习。

十一、嵌套使用上述的十种格式

灵活使用上述的这些简单语法，将是我们沉醉下自我的文字内容创作上，而忽略文档格式的事后诸葛行为，即不用在排版了，所见即所得。