• 版块
    • 热门
    • 最新
    • 标签
    • 关于
    • 捐赠
    • 注册
    • 登录

    Markdown使用手册

    已定时 已固定 已锁定 已移动 公告
    8 帖子 2 发布者 3.0k 浏览
    正在加载更多帖子
    • 从旧到新
    • 从新到旧
    • 最多赞同
      回复
      • 在新帖中回复
      登录后回复
      此主题已被删除。只有拥有主题管理权限的用户可以查看。
      • A 离线
        admin 船长
        最后由 编辑

        主要内容

        Markdown是_什么_?

        _谁_发明了这么个东西?

        _为什么_要使用它?

        _怎么_使用?

        都_谁_在用?####

        感觉有意思?不怕你看见,就怕你试试

        正文

        1. Markdown是什么?

        Markdown是一种轻量级标记语言,它以纯文本形式(易读、易写、易更改)编写文档,并最终以HTML格式发布。
        Markdown也可以理解为将以MARKDOWN语言编写的语言转换成HTML内容的工具,最初是一个perl脚本_Markdown.pl_。

        2. _谁_发明了这么个东西?

        它由Aaron Swartz和John Gruber共同设计,Aaron Swartz就是那位于去年(2013年1月11日)自杀,有着开挂一般人生经历的程序员。维基百科对他的介绍是:软件工程师、作家、政治组织者、互联网活动家、维基百科人。

        他有着足以让你跪拜的人生经历:

        • 14岁参与RSS 1.0规格标准的制订。
        • 2004年入读斯坦福,之后退学。
        • 2005年创建Infogami,之后与Reddit合并成为其合伙人。
        • 2010年创立求进会(Demand Progress),积极参与禁止网络盗版法案(SOPA)活动,最终该提案居然被撤回。
        • 2011年7月19日,因被控从MIT和JSTOR下载480万篇学术论文并以免费形式上传于网络被捕。
        • 2013年1月自杀身亡。

        Aaron Swartz

        天才都有早逝的归途(又是一位犹太人)。

        3. _为什么_要使用它?

        • 它是易读(看起开舒服)、易写(语法简单)、易更改纯文本。处处体现着极简主义的影子。
        • 兼容HTML,可以转换为HTML格式发布。
        • 跨平台使用。
        • 越来越多的网站支持Markdown。
        • 更方便清晰的组织你的电子邮件。(Markdown-here, Airmail)
        • 摆脱Word(我不是认真的)。

        4. _怎么_使用?

        如果不算扩展,Markdown的语法绝对简单到让你爱不释手。

        废话太多,下面正文,Markdown语法主要分为如下几大部分:
        标题,段落,区块引用,代码区块,强调,列表,分割线,链接,图片,反斜杠 \,符号'`'。

        4.1 标题

        两种形式:
        1)使用=和-标记一级和二级标题。

        一级标题
        =========
        二级标题
        ---------

        效果:

        一级标题

        二级标题

        2)使用#,可表示1-6级标题。

        # 一级标题
        ## 二级标题
        ### 三级标题
        #### 四级标题
        ##### 五级标题
        ###### 六级标题

        效果:

        一级标题

        二级标题

        三级标题

        四级标题

        五级标题
        六级标题

        4.2 段落

        段落的前后要有空行,所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车(引用中换行省略回车)。

        4.3 区块引用

        在段落的每行或者只在第一行使用符号>,还可使用多个嵌套引用,如:

        > 区块引用
        >> 嵌套引用

        效果:

        区块引用

        嵌套引用

        4.4 代码区块

        代码区块的建立是在每行加上4个空格或者一个制表符(如同写代码一样)。如
        普通段落:

        void main()
        {
        printf("Hello, Markdown.");
        }

        代码区块:

        void main()
        {
            printf("Hello, Markdown.");
        }
        

        注意:需要和普通段落之间存在空行。

        4.5 强调

        在强调内容两侧分别加上*或者_,如:

        *斜体*,_斜体_
        **粗体**,__粗体__

        效果:

        斜体,斜体
        粗体,粗体

        4.6 列表

        使用·、+、或-标记无序列表,如:

        -(+*) 第一项
        -(+*) 第二项
        - (+*)第三项

        注意:标记后面最少有一个_空格_或_制表符_。若不在引用区块中,必须和前方段落之间存在空行。

        效果:

        • 第一项
        • 第二项
        • 第三项

        有序列表的标记方式是将上述的符号换成数字,并辅以.,如:

        1 . 第一项
        2 . 第二项
        3 . 第三项

        效果:

        1. 第一项
        2. 第二项
        3. 第三项

        4.7 分割线

        分割线最常使用就是三个或以上*,还可以使用-和_。

        4.8 链接

        链接可以由两种形式生成:行内式和参考式。
        行内式:

        [younghz的Markdown库](https:://github.com/younghz/Markdown "Markdown")。

        效果:

        younghz的Markdown库。

        参考式:

        [younghz的Markdown库1][1]
        [younghz的Markdown库2][2]
        [1]:https:://github.com/younghz/Markdown "Markdown"
        [2]:https:://github.com/younghz/Markdown "Markdown"

        效果:

        younghz的Markdown库1
        younghz的Markdown库2

        注意:上述的[1]:https:://github.com/younghz/Markdown "Markdown"不出现在区块中。

        4.9 图片

        添加图片的形式和链接相似,只需在链接的基础上前方加一个!。

        4.10 反斜杠\

        相当于反转义作用。使符号成为普通符号。

        4.11 符号'`'

        起到标记作用。如:

        `ctrl+a`

        效果:

        ctrl+a

        5. 都_谁_在用?####

        Markdown的使用者:

        • GitHub
        • 简书
        • Stack Overflow
        • Apollo
        • Moodle
        • Reddit
        • 等等

        6. 感觉有意思?趁热打铁,推荐几个_工具_。

        • Chrome下的stackedit插件可以离线使用,很爽。也不用担心平台受限。
          在线的dillinger.io算是评价好的了,可是不能离线使用。
        • Windowns下的MarkdownPad也用过,不过免费版的体验不是很好。
        • Mac下的Mou是国人贡献的,口碑很好。推荐。
        • Linux下的ReText不错。

        其实在对语法了如于心的话,直接用编辑器就可以了,脑子里满满的都是格式化好的文本啊。
        我现在使用马克飞象 + Markdown-here,先编辑好,然后一键格式化,挺方便。


        注意:不同的Markdown解释器或工具对相应语法(扩展语法)的解释效果不尽相同,具体可参见工具的使用说明。
        虽然有人想出面搞一个所谓的标准化的Markdown,[没想到还惹怒了健在的创始人John Gruber]
        (http://blog.codinghorror.com/standard-markdown-is-now-common-markdown/)。


        以上基本是所有traditonal markdown的语法。

        其它:

        列表的使用(非traditonal markdown):

        用|表示表格纵向边界,表头和表内容用-隔开,并可用:进行对齐设置,两边都有:则表示居中,若不加:则默认左对齐。

        代码库 链接
        MarkDown https://github.com/younghz/Markdown
        moos-young https://github.com/younghz/moos-young

        关于其它扩展语法可参见具体工具的使用说明。

        1 条回复 最后回复 回复 引用 0
        • 天苯天 离线
          天苯 大副
          最后由 编辑

          中文版的MarkDown教程,Cool

          Welcome to our Telegram group: https://t.me/jollacn
          —— I can do nothing but behave like a clown. 🖋️

          A 1 条回复 最后回复 回复 引用 0
          • A 离线
            admin 船长 @天苯
            最后由 编辑

            @天苯 前排膜拜天苯大神 😂

            天苯天 1 条回复 最后回复 回复 引用 0
            • 天苯天 离线
              天苯 大副 @admin
              最后由 编辑

              @admin 求不黑……😷

              Welcome to our Telegram group: https://t.me/jollacn
              —— I can do nothing but behave like a clown. 🖋️

              A 1 条回复 最后回复 回复 引用 0
              • A 离线
                admin 船长 @天苯
                最后由 编辑

                @天苯 已加大神title

                天苯天 2 条回复 最后回复 回复 引用 0
                • 天苯天 离线
                  天苯 大副 @admin
                  最后由 编辑

                  @admin o_O没懂……啥title?

                  Welcome to our Telegram group: https://t.me/jollacn
                  —— I can do nothing but behave like a clown. 🖋️

                  1 条回复 最后回复 回复 引用 0
                  • 天苯天 离线
                    天苯 大副 @admin
                    最后由 编辑

                    @admin 噢……昵称旁的标签?

                    Welcome to our Telegram group: https://t.me/jollacn
                    —— I can do nothing but behave like a clown. 🖋️

                    A 1 条回复 最后回复 回复 引用 0
                    • A 离线
                      admin 船长 @天苯
                      最后由 编辑

                      @天苯 是的,大神

                      1 条回复 最后回复 回复 引用 0
                      • 1 / 1
                      • 第一个帖子
                        最后一个帖子
                      Copyright © 2017-2024 旗鱼俱乐部 旗鱼系统交流论坛
                      🐟🐠🐡论坛客户端下载🐟🐠🐡
                      友情链接 SailfishOS.org | Jolla | 官方论坛 | 移植wiki| 第三方商店 | BirdZhang的博客| Securest
                      除非另有声明,本网站采用知识共享“署名 4.0 中国大陆”许可协议授权。
                      根据相关法律法规,本站不对欧盟用户提供服务。
                      Powered by NodeBB