Markdown——Sublime Text 3

Markdown in Sublime Text 3

Sublime Text 3 非常轻量小巧，打开文件的速度也非常快，所以最近想要使用它来写Markdown笔记，Sublime Text 3只要安装插件就可以配置了，这里记录下安装配置过程和遇到的几个问题。

配置：

• MarkdownEdittiing：支持Markdown编辑的插件。
• MarkdownPreview： 支持Markdown预览插件。
• LiveReload：支持MarkdownPreview预览时动态刷新更新。

安装过程不用说，网上很多，比较简单，就是Sublime Text 3的install packages 命令就可以，主要是一些配置比较关键，尤其是MarkdownPreview的配置比较关键。MarkdownPreview的配置大部分可以参见官方文档。

配置

依次安装三个插件之后，首先在key bindings里面配置MarkdownPreview的快捷键。

{ "keys": ["alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser":"markdown"} },

然后配置MarkdownPreview的设置：

1. LiveReload的动态刷新，一般来说这一项默认是True，可以不用配置。

   "enable_autoreload": true,
   

2. 配置Mathjax，支持数学公式显示。
   官网上给出的是直接添加js里面的markdown，但是发现不起作用，可以参考这个链接。
   要同时配置js和markdown-extensions。

   "enable_mathjax":true,
   "js": [
   "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js",
           "res://MarkdownPreview/js/math_config.js",
   ],
   "markdown_extensions": {
       "pymdownx.arithmatex": {
           "generic": true
       }
   }
   

3. 同时可能会遇到加了Mathjax之后，原来的表格等不显示的问题。这时候要把默认配置的markdown-extensions复制过来然后把arithmatex的部分加在它之后。可以参考这个链接。

   "markdown_extensions": [
           // Python Markdown Extra with SuperFences.
           // You can't include "extra" and "superfences"
           // as "fenced_code" can not be included with "superfences",
           // so we include the pieces separately.
           "markdown.extensions.footnotes",
           "markdown.extensions.attr_list",
           "markdown.extensions.def_list",
           "markdown.extensions.tables",
           "markdown.extensions.abbr",
           "pymdownx.betterem",
           {
               "markdown.extensions.codehilite": {
                   "guess_lang": false
               }
           },
           // Extra's Markdown parsing in raw HTML cannot be
           // included by itself, but "pymdownx" exposes it so we can.
           "pymdownx.extrarawhtml",
   
           // More default Python Markdown extensions
           {
               "markdown.extensions.toc":
               {
                   "permalink": "\ue157"
               }
           },
           "markdown.extensions.meta",
           "markdown.extensions.sane_lists",
           "markdown.extensions.smarty",
           "markdown.extensions.wikilinks",
           "markdown.extensions.admonition",
   
           // PyMdown extensions that help give a GitHub-ish feel
           {
               "pymdownx.superfences": { // Nested fences and UML support
                   "custom_fences": [
                       {
                           "name": "flow",
                           "class": "uml-flowchart",
                           "format": {"!!python/name": "pymdownx.superfences.fence_code_format"}
                       },
                       {
                           "name": "sequence",
                           "class": "uml-sequence-diagram",
                           "format": {"!!python/name": "pymdownx.superfences.fence_code_format"}
                       }
                   ]
               }
           },
           {
               "pymdownx.magiclink": {   // Auto linkify URLs and email addresses
                   "repo_url_shortener": true,
                   "repo_url_shorthand": true
               }
           },
           "pymdownx.tasklist",     // Task lists
           {
               "pymdownx.tilde": {  // Provide ~~delete~~
                   "subscript": false
               }
           },
           {
               "pymdownx.emoji": {  // Provide GitHub's emojis
                   "emoji_index": {"!!python/name": "pymdownx.emoji.gemoji"},
                   "emoji_generator": {"!!python/name": "pymdownx.emoji.to_png"},
                   "alt": "short",
                   "options": {
                       "attributes": {
                           "align": "absmiddle",
                           "height": "20px",
                           "width": "20px"
                       },
                       "image_path": "https://github.githubassets.com/images/icons/emoji/unicode/",
                       "non_standard_image_path": "https://github.githubassets.com/images/icons/emoji/"
                   }
               }
           },
           {
               "pymdownx.arithmatex": {
                   "generic": true
               }
           }
       ],
   

其他配置

可以考虑加入Evernote插件，直接把markdown保存到印象笔记里。