• MarkDown写作技巧


    前言

    年轻的我们往往苦恼于没有充实的社会经历、社会阅历,很难有较强的个人能力、个人魅力!就个人能力而言,本 人主要把它分为两种:“吸收能力”和“输出能力”。吸收能力主要体现了个人对外界知识的摄入能力,主要包括:学习能力、阅读能力、听取能力、分析能力、理 解能力等,这些能力可以帮助自己吸取理解进而加以分析自身的外界知识。与吸收能力相比,输出能力更是体现个人社会价值的一种能力了,其主要包括:概括能 力、总结能力、表达能力、沟通能力、讲演能力和写作能力等。为了更好地表达与沟通,也许我们要做的更多的应该是分析、概括和总结了,然而,这个阶段写作能 力往往是个人成长、社会分工中最重要的一种技能了。科学技术是第一生产力!本人却始终坚信: 知识分享是科学技术的第一生产力!(技术小白对’能力’这个概念不太全面的体悟,希望大家多指点,共同勉励、共同进步!)

    谈到写作,人们可能更青睐于word或者LaTeX等等写作工具(特别是写论文大牛的科学研究者)。本人在读研期间也多次跟着我的导师(孙小兵老师)一起用LaTeX写过几篇英文文章(点击这里), 深深体会到LaTeX排版论文的便利。然而,对于一些规范性要求不算太高的博客文章,LaTeX自然是不适合的,网络上大部分的免费博客的在线编辑系统不 免也让人会有些抓狂。作为技术宅+博客作者的我们,也许Markdown是另一个更佳的写作工具了。下面让我们来初探一下Markdown:

    什么是MarkDown

    Markdown到底是个啥?要解决这个what性质的问题,也许我们可以看看它的官方网站或者维基百科上 的阐述。其实,Markdown是一个易读易写的网络文本书写工具。它可以很好地支持github,Stackoverflow等各大开源网站,此外,为 了方便地将文本内容转化成HTML格式,Markdown形成了自己的一套语法,其语法目标:成为一种适用于网络的书写语言。总之,Markdown 的目标是实现「易读易写」。

    MarkDown语法

    代码

    对 于一个技术宅,Markdown对代码编排的支持及其使用的便利性是非常重要的,Markdown支持的语言很多:actionscript, apache, bash, clojure, cmake, coffeescript, cpp, cs, css, d, delphi, django, erlang, go, haskell, html, http, ini, java, javascript, json, lisp, lua, markdown, matlab, nginx, objectivec, perl, php, python, r, ruby, scala, smalltalk, sql, tex, vbscript, xml.

    下面是本人例举python代码的编排结果:

    def g(x):
        yield from range(x, 0, -1)
    yield from range(x)
    

    注意事项:编排python代码时,需要在代码与文字之间隔一行且在代码之前至少保持4个空格缩进。

    标题

    文章内容较多时需要使用标题分段,Markdown支持两种标题标记方式:

    1. 在标题下方添加下添加多个’=’或者多个’-‘来表达标题的不同等级;
    2. 在标题左右添加’#’,根据’#’数量不同区分标题等级。 例:#标题1# ##标题2##

    斜粗体

    Markdown使用’‘表示字体的斜体或者粗体,当文字左右添加一个’‘时表示斜体,两个’‘表示粗体,三个’‘表示斜粗体。 例:*斜体* **粗体** ***粗斜体***

    链接

    常用的链接主要有文字链接和网址链接:

    • 文字链接,用’[]’将要链接的文字括起来,后面的链接用’()’将括起来紧接其后; 例:[要链接的文字](网址)
    • 网址链接,用’<>’将网址括起来即可。 例:<网址>

    列表

    • 普通无序列表,在文字前面用’+,-,*‘等符号,并在符号与文字之间空格一格;例:

      - 列表文本前使用 [减号+空格]
      + 列表文本前使用 [加号+空格]
      * 列表文本前使用 [星号+空格]

    • 普通有序列表,在文字前面添加’1. ‘等数字和’.’号,并在其后加一个空格。例:

      1. 列表前使用 [数字+空格]
      2. 我们会自动帮你添加数字
      3. 不用担心数字不对,显示的时候我们会自动把这行的 7 纠正为 3

    引用

    引用前使用’>’+空格,每行前都要添加哦。例:
    > 引用文本前使用 [大于号+空格]
    > 折行可以不加,新起一行都要加上哦

    图片

    跟链接的方法区别在于前面加了个感叹号 ‘!’,这样是不是觉得好记多了呢? 例:![图片名称](http://图片网址)

    换行

    如果是另起一行,只需要在结尾加两个空格,如果是另起一个段落,只需要空一行就行了。

    分隔符

    如果你有写分割线的习惯,可以新起一行输入三个减号’-‘。当前后都有段落时,请空出一行。

    公式

    当你需要在编辑器中插入数学公式时,可以使用两个美元符 ‘$$’ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。

    符号转义

    如果你的描述中需要用到 markdown 的符号,比如 ‘# *‘ 等,但又不想它被转义,这时候可以在这些符号前加反斜杠,如 # * 进行避免。


    注:更多细节可以查看 Markdown 语法说明 (简体中文版),或者 github对Markdown的特征描述

    MarkDown优势

    根据调查,本人总结了Markdown猪油有如下优势:

    • 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
    • 让你专注于文字而不是排版。
    • 格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
    • Markdown 的标记语法有极好的可读性。

    MarkDown写作工具

    一切就这么简单。Markdown之所以越来越流行,是因为它足够简单。试试吧~

    在线编辑器

    浏览器插件

    • MaDe (Chrome)

    语言包

    编辑器/IDE插件

    参考链接

    1. http://wowubuntu.com/markdown/
    2. https://zh.wikipedia.org/wiki/Markdown
    3. http://www.jianshu.com/p/q81RER
    4. http://markdown.tw
    5. https://www.zybuluo.com/mdeditor
    6. https://www.zhihu.com/question/20409634
    7. http://www.markdown.cn/
    8. http://sspai.com/markdown-guide
    9. https://segmentfault.com/markdown
    10. https://guides.github.com/features/mastering-markdown/
    11. https://atom.io/packages/markdown-writer
    12. https://atom.io/packages/markdown-writer
    13. https://pypi.python.org/pypi/Markdown
    14. http://www.markdowntutorial.com/
    15. http://anwensf.com/markdown
  • 相关阅读:
    c# 深拷贝与浅拷贝
    SQLServer性能优化 .net开发菜鸟总结
    Ajax自定义无刷新控件实现
    APScheduler库的详细用法
    catkin在centos中的安装
    第五次任务实现与项目总结第六组
    Javascript教程:获取当前地址栏url
    窗口处理问题
    HTML中area标签
    Asp.net中Frameset的使用小结
  • 原文地址:https://www.cnblogs.com/huiyang865/p/5793517.html
Copyright © 2020-2023  润新知