标签: markdown

  • 学习markdown语言范本

    微信公众号排版工具。问题或建议,请公众号留言。程序员翻身

    建议使用 Chrome 浏览器,体验最佳效果。

    使用微信公众号编辑器有一个十分头疼的问题:粘贴出来的代码,格式错乱,空间小还带行号,而且特别丑。Markdown.com.cn编辑器能够解决这个问题。

    Markdown是一种轻量级的「标记语言」。

    请阅读下方文本熟悉工具使用方法,本文可直接拷贝到微信中预览。

    1 Markdown.com.cn 简介

    • 支持自定义样式的 Markdown 编辑器
    • 支持微信公众号、知乎和稀土掘金
    • 点击右上方对应图标,一键复制到各平台

    2 Markdown语法教程

    2.1 标题

    不同数量的#可以完成不同的标题,如下:

    一级标题

    二级标题

    三级标题

    2.2 字体

    粗体、斜体、粗体和斜体,删除线,需要在文字前后加不同的标记符号。如下:

    这个是粗体

    这个是斜体

    这个是粗体加斜体

    这里想用删除线

    注:如果想给字体换颜色、字体或者居中显示,需要使用内嵌HTML来实现。

    2.3 无序列表

    无序列表的使用,在符号-后加空格使用。如下:

    • 无序列表 1
    • 无序列表 2
    • 无序列表 3

    如果要控制列表的层级,则需要在符号-前使用空格。如下:

    • 无序列表 1
    • 无序列表 2
      • 无序列表 2.1
      • 无序列表 2.2

    由于微信原因,最多支持到二级列表

    2.4 有序列表

    有序列表的使用,在数字及符号.后加空格后输入内容,如下:

    1. 有序列表 1
    2. 有序列表 2
    3. 有序列表 3

    2.5 引用

    引用的格式是在符号>后面书写文字。如下:

    读一本好书,就是在和高尚的人谈话。 ——歌德

    雇用制度对工人不利,但工人根本无力摆脱这个制度。 ——阮一峰

    2.7 链接

    微信公众号仅支持公众号文章链接,即域名为https://mp.weixin.qq.com/的合法链接。使用方法如下所示:

    对于该论述,欢迎读者查阅之前发过的文章,你是《未来世界的幸存者》么?

    2.8 图片

    插入图片,格式如下:

    markdown logo

    支持 jpg、png、gif、svg 等图片格式,其中 svg 文件仅可在微信公众平台中使用,svg 文件示例如下:

    支持图片拖拽和截图粘贴到编辑器中。

    注:支持图片 拖拽和截图粘贴 到编辑器中,仅支持 https 的图片,图片粘贴到微信时会自动上传微信服务器。

    2.9 分割线

    可以在一行中用三个以上的减号来建立一个分隔线,同时需要在分隔线的上面空一行。如下:


    2.10 表格

    可以使用冒号来定义表格的对齐方式,如下:

    姓名 年龄 工作
    小可爱 18 吃可爱多
    小小勇敢 20 爬棵勇敢树
    小小小机智 22 看一本机智书

    3. 特殊语法

    3.1 脚注

    支持平台:微信公众号、知乎。

    脚注与链接的区别如下所示:

    链接:[文字](链接)
    脚注:[文字](脚注解释 "脚注名字")

    有人认为在大前端时代的背景下,移动端开发(Android、IOS)将逐步退出历史舞台。

    全栈工程师在业务开发流程中起到了至关重要的作用。

    脚注内容请拉到最下面观看。

    3.2 代码块

    支持平台:微信代码主题仅支持微信公众号!其他主题无限制。

    如果在一个行内需要引用代码,只要用反引号引起来就好,如下:

    Use the printf() function.

    在需要高亮的代码块的前一行及后一行使用三个反引号,同时第一行反引号后面表示代码块所使用的语言,如下:

    // FileName: HelloWorld.java
    public class HelloWorld {
      // Java 入口程序,程序从此入口
      public static void main(String[] args) {
        System.out.println("Hello,World!"); // 向控制台打印一条语句
      }
    }

    支持以下语言种类:

    bash
    clojure,cpp,cs,css
    dart,dockerfile, diff
    erlang
    go,gradle,groovy
    haskell
    java,javascript,json,julia
    kotlin
    lisp,lua
    makefile,markdown,matlab
    objectivec
    perl,php,python
    r,ruby,rust
    scala,shell,sql,swift
    tex,typescript
    verilog,vhdl
    xml
    yaml

    如果想要更换代码高亮样式,可在上方代码主题中挑选。

    其中微信代码主题与微信官方一致,有以下注意事项:

    • 带行号且不换行,代码大小与官方一致
    • 需要在代码块处标志语言,否则无法高亮
    • 粘贴到公众号后,用鼠标点代码块内外一次,完成高亮

    diff 不能同时和其他语言的高亮同时显示,且需要调整代码主题为微信代码主题以外的代码主题才能看到 diff 效果,使用效果如下:

    + 新增项
    - 删除项

    其他主题不带行号,可自定义是否换行,代码大小与当前编辑器一致

    3.3 数学公式

    支持平台:微信公众号、知乎。

    行内公式使用方法,比如这个化学公式:$ce{Hg^2+ ->[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}$

    块公式使用方法如下:

    $$H(D_2) = -left(frac{2}{4}log_2 frac{2}{4} + frac{2}{4}log_2 frac{2}{4}right) = 1$$

    矩阵:

    $$
    begin{pmatrix}
    1 & a_1 & a_1^2 & cdots & a_1^n
    1 & a_2 & a_2^2 & cdots & a_2^n
    vdots & vdots & vdots & ddots & vdots
    1 & a_m & a_m^2 & cdots & a_m^n
    end{pmatrix}
    $$

    公式由于微信不支持,目前的解决方案是转成 svg 放到微信中,无需调整,矢量不失真。

    目前测试如果公式量过大,在 Chrome 下会存在粘贴后无响应,但是在 Firefox 中始终能够成功。

    3.4 TOC

    支持平台:微信公众号、知乎。

    TOC 全称为 Table of Content,列出全部标题。

    [TOC]

    由于微信只支持到二级列表,本工具仅支持二级标题和三级标题的显示。

    3.5 注音符号

    支持平台:微信公众号。

    支持注音符号,用法如下:

    Markdown Nice 这么好用,简直是{喜大普奔|hē hē hē hē}呀!

    3.6 横屏滑动幻灯片

    支持平台:微信公众号。

    通过<![](url),![](url)>这种语法设置横屏滑动滑动片,具体用法如下:

    <蓝1,绿2,红3>

    4 其他语法

    4.1 HTML

    支持原生 HTML 语法,请写内联样式,如下:

    橙色居右
    橙色居中

    4.2 UML

    不支持,推荐使用开源工具https://draw.io/制作后再导入图片

    5 致谢