2015年10月15日 星期四

用StackEdit寫Markdown,並輸出至網誌

以下是我用在StackEdit編輯的Markdown文件


用StackEdit寫Markdown,並輸出至網誌!

安安!我是StackEdit1的Markdown教學。別把我刪掉囉~我可是很有用的

Note: 如果刪掉了,可以至這裡重新下載

翻譯:Paul



文件

StackEdit會自動存檔,而且是存在瀏覽器,代表可以離線編輯

Note:

  • 在第一次開啟StackEdit後便可以離線編輯。
  • 因為文件是儲存在瀏覽器,意思是在不同瀏覽器和不同電腦是不共用存檔的。
  • 刪除瀏覽器瀏覽資料的話會同時刪除所有本地文件!
  • 為了保護您寶貴的資料,請將文件同步到Google DriveDropbox (詳情請見 同步 )

建立一個新文件

  • (右上角按鈕) –> New document

切換其他文件

  • (右上角按鈕) –> 點開後可以看到你所有的文件
  • 使用Ctrl+[Ctrl+]可以快速切換其他文件

重新命名

  • 點右上角的檔名可開始重新命名,完成編輯點Knter儲存
    rename image

刪除文件

  • (右上角按鈕) –> Delete document
    • 或者 –> Manage documents

匯出文件

  • (左上角按鈕 ) –> Export to disk

關於匯出格式請看 發佈文件


同步

StackEdit支援 Google Drive Dropbox 同步。

Note:

  • Full access to Google Drive or Dropbox is required to be able to import any document in StackEdit. Permission restrictions can be configured in the settings.
  • Imported documents are downloaded in your browser and are not transmitted to a server.
  • If you experience problems saving your documents on Google Drive, check and optionally disable browser extensions, such as Disconnect.

開啟文件

  • (左上角按鈕) –> Synchronize –> Open from…
  • 一旦開啟,文件將會自動與雲端同步。

儲存文件

  • (左上角按鈕) –> Synchronize –> Save on…
  • 即使文件已和 Google DriveDropbox 同步,你仍然可以將文件儲存至其他雲端,StackEdit可以將同個文件與多個雲端同步。

同步文件

  • 一旦文件和 Google Drive Dropbox 檔案連結,StackEdit會每三分鐘自動和雲端同步。
  • 點右上方的 按鈕以立即進行同步。

管理文件同步

  • (左上角按鈕) –> Synchronize –> Manage synchronization
    • 可以取消同步

Note: 如果你在 Google DriveDropbox 把文件刪除,你的StackEdit文件將無法進行同步。


發佈

可以直接在StackEdit發佈你的文件!StackEdit 目前支援 Blogger, Dropbox, Gist, GitHub, Google Drive, Tumblr, WordPress 或者任何 SSH server.

發佈文件

  • (左上角按鈕) –> Publish –> 選擇要進行發佈網站
  • 選擇發佈格式
    • Markdown:如果要發佈的網站支援Markdown語法(例如GitHub)
    • HTML:把Markdown轉成HTML進行發佈(至網誌)
    • Template:擁有最完整的控制權

Note: 預設的Template是一個簡單的網頁,你可以在 –> Settings –> Advanced設定Template。

更新已發佈的文件

進行發佈之後,StackEdit會將文件與發佈網站進行連結,以利於你進行更新。點右上角的按鈕以進行更新。

管理發佈的文件

  • -> Manage publication –> 可移除這個文件的發佈地址

Note: 移除之後,文件將永遠失去與該發佈文章的連結,必須進行重新發佈。


Markdown Extra

StackEdit 支援 Markdown Extra, 提供 Markdown 一些很讚的新語法!

Note:

表格

Markdown Extra 的表格語法:

商品 價格
MacBook Pro $999
iPhone $888
Apple Watch $777

靠左 置中 靠右
Computer $1600000 5
Phone $12 12
Pipe $1 234

清單

Markdown Extra 的清單語法:

Term 1
Term 2
Definition A
Definition B
Term 3

Definition C

Definition D

part of definition D

程式碼區塊

和GitHub的程式碼區塊一樣是用 Highlight.js 語法變色:

// Foo
var bar = 0;

Tip: –> Settings –> Extensions –> Markdown Extra:可以把Highlight.js改成Prettify

Note: 關於PrettifyHighlight.js

  • about Prettify syntax highlighting here,
  • about Highlight.js syntax highlighting here.

Footnotes

You can create footnotes like this2.

SmartyPants

SmartyPants converts ASCII punctuation characters into “smart” typographic punctuation HTML entities. For example:

ASCII HTML
Single backticks 'Isn't this fun?' ‘Isn’t this fun?’
Quotes "Isn't this fun?" “Isn’t this fun?”
Dashes -- is en-dash, --- is em-dash – is en-dash, — is em-dash

Table of contents

You can insert a table of contents using the marker [TOC]:

MathJax

You can render LaTeX mathematical expressions using MathJax, as on math.stackexchange.com:

The Gamma function satisfying is via the Euler integral

Tip: To make sure mathematical expressions are rendered properly on your website, include MathJax into your template:

<script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>

Note: You can find more information about LaTeX mathematical expressions here.

UML diagrams

You can also render sequence diagrams like this:

Created with Raphaël 2.1.2AliceAliceBobBobHello Bob, how are you?Bob thinksI am good thanks!

And flow charts like this:

Created with Raphaël 2.1.2StartMy OperationYes or No?Endyesno

Note: You can find more information:

  • about Sequence diagrams syntax here,
  • about Flow charts syntax here.

Support StackEdit



  1. StackEdit is a full-featured, open-source Markdown editor based on PageDown, the Markdown library used by Stack Overflow and the other Stack Exchange sites.
  2. Here is the text of the footnote.