ラベル Markdown の投稿を表示しています。 すべての投稿を表示
ラベル Markdown の投稿を表示しています。 すべての投稿を表示

MarsEdit や Marked で kramdown を用いた変換が機能しなくなったけど回避できたという話

このエントリーをはてなブックマークに追加 Pocket

先日、MacBook Pro の Jekyll をバージョンアップしたところ、MarsEdit や Marked に外部 Markdown エンジンとして指定している kramdown が機能しなくなってしまいました。

挙動を探ってみると以下のような状況です。

  • ASCII 文字のみを入力すると機能する。
  • ターミナルで実行すると機能する。

つまり、MarsEdit に非 ASCII 文字を入力する(Marked の場合は非 ASCII 文字が含まれるファイルを開く)と、何も出力されなくなってしまったのです。

MarsEdit - the blog editor for WordPress, Tumblr, Blogger and more.
バージョン: 3.6.2
価格: ¥4,000(2013.12.28 時点)
サイズ: 7.9 MB
カテゴリ: ソーシャルネットワーキング, 仕事効率化
販売元: Red Sweater Software
全てのバージョンの評価: ★4.0(10件の評価)

Marked
バージョン: 1.4.3
価格: ¥400(2013.12.28 時点)
サイズ: 7.7 MB
カテゴリ: 仕事効率化, ユーティリティ
販売元: Brett Terpstra
全てのバージョンの評価: ★4.5(14件の評価)

これは困ったということで、解決(回避)に向けて試行錯誤してみました。

[Moblogger] Markdown で書いて HTML に変換してポスト

このエントリーをはてなブックマークに追加 Pocket

Markdown がお気に入りの @toshiya240 です。

最近、Markdown に関するエントリをいくつか見かけました。

Markdown については過去に何回か私も書いています。

Moblogger でも Markdown で書けると良いなぁと思ったので、手始めに MyScripts で実装してみました。


MarsEdit 3.6 でポスト時にフィルタ適用可能になった

このエントリーをはてなブックマークに追加 Pocket

MarsEdit 3.6 でプレビューフィルタを適用してポストすることができるようになりました。

MarsEdit can now apply the preview filter as part of the publishing process.

This is primarily of interest to folks who write in HTML Text mode with a text filter such as Markdown, but publish to a blog that doesn’t support it natively.

via Red Sweater Blog – MarsEdit 3.6: Bug Fixes With A Twist

Mac App Store 版はまだ 3.5.9 ですが、Red Sweater Blog によればサブミット済みとのことなので程なくアップデート可能になるでしょう。

MarsEdit - the blog editor for WordPress, Tumblr, Blogger and more. App
バージョン: 3.5.9
現在の価格: ¥3,450
サイズ: 7.9 MB
カテゴリ: ソーシャルネットワーキング, 仕事効率化
販売元: Red Sweater Software - Red Sweater Software
全てのバージョンの評価: ★4.0(8件の評価)

目次

設定

ブログの設定画面の [Posting] > [Before posting] > [Apply preview filter to content] のチェックをオンにします。

Marsedit blog settings

Markdown で書いてそのままポストできる

私は 2010年くらいから Markdown を使うようになりましたが、Markdown で書いてポストするには以下のようにしていました。

Markdown から HTML に変換する

書き終わったら、おもむろに

⌘ + ⇧ + T

です!

via Happy-Go-Lucky: [MarsEdit] Markdown 記法でブログを書く

今回の設定をオンにすることで書いてそのままポストすることができるようになります。 これは手間が減って嬉しいです。

ただし、ポスト時に変換してブログシステムに送信するため、ポスト済みのエントリを編集する際は HTML を扱うことになります。ブログシステム側で Markdown をサポート可能な場合1はフィルタを適用せずそのままポストした方がよいでしょう。

ちなみに、私は MarsEdit で拡張 Markdown を使うと捗るぞ という理由で Markdown エンジンとして Kramdown を採用しています。

Markdown オススメですよ。

  1. Tumblr や WordPress with PHP Markdown など。Posterous はなくなってしまいましたね。↩

MarsEdit で拡張 Markdown を使うと捗るぞ

このエントリーをはてなブックマークに追加 Pocket

MarsEdit - the blog editor for WordPress, Tumblr, Blogger and more. App
バージョン: 3.5.8
現在の価格: ¥3,450
サイズ: 7.9 MB
カテゴリ: ソーシャルネットワーキング, 仕事効率化
販売元: Red Sweater Software - Red Sweater Software
全てのバージョンの評価: ★4.0(5件の評価)

Markdown、してますか?

実は私はブログではあまり使っていません1。 しかし、Jekyll をきっかけに再び Markdown 熱が高まってきました。

Jekyll では複数の Markdown エンジンがサポートされています。 これらの Markdown エンジンではオリジナルの Markdown にない機能が実装されており、 表現力が増しています。

そして、MarsEdit がプレビューで使用する Text Filter としてこれらを使用することでブログの執筆が捗ると思って試したみたところなかなかよさそうです2。



目次

拡張 Markdown

各 Markdown エンジンとも PHP Markdown Extra を拡張の基本としているようです。

Jekyll がサポートしている Markdown エンジンは以下のものです。

  1. Maruku
  2. RDiscount
  3. Kramdown
  4. Redcarpet

PHP Markdown Extra の対応状況はそれぞれ異なりますので後述します。

今回は標準 Markdown にはない表現ができるようになる拡張に注目しました。

表組み

HTML で表を書くのはちょっと面倒ですよね。 シンプルな表であれば以下のように書くことができます3。

First Header | Second Header
------------ | -------------
Content Cell | Content Cell
Content Cell | Content Cell 

上記のように書くと以下のような HTML に変換されます。

First HeaderSecond Header
Content Cell Content Cell
Content Cell Content Cell

セルのセンタリングや右寄せなどもできます。

|---
| Default aligned | Left aligned | Center aligned | Right aligned
|-|:-|:-:|-:
| First body part | Second cell | Third cell | fourth cell
| Second line |foo | **strong** | baz | Third line |quux | baz | bar
|---
| Second body
| 2 line
|===
| Footer row 
Default alignedLeft alignedCenter alignedRight aligned
First body part Second cell Third cell fourth cell
Second line foo strong baz
Third line quux baz bar
Second body      
2 line      
Footer row      

[目次へ]

脚注

脚注[^1]を記述することができる。
[^1]: 本文の下につける注釈 

本エントリでもいくつか脚注を記載しています。

[目次へ]

定義リスト

HTML の dl, dt, dd になります。

Markdown
: 軽量マークアップ言語の一つである。 電子メールでプレインテキストを装飾する際の慣習から着想を得ている。
PHP Markdown Extra
: Markdown にいろいろな拡張を施したもの。 
Markdown
軽量マークアップ言語の一つである。 電子メールでプレインテキストを装飾する際の慣習から着想を得ている。
PHP Markdown Extra
Markdown にいろいろな拡張を施したもの。

[目次へ]

見出しの ID 属性の指定(目次の自動生成も)

見出しに ID 属性を指定することができます。

# 見出し1 {#heading1}
## 見出し2 {#heading2} 

のように ID を指定して、

[見出し1 へのリンク](#heading1) 

のようにリンクすることができます。

Maruku と Kramdown では以下のように記述することで目次を自動生成することができます4。

* 目次(この要素は HTML として出力されません)
{.toc} 

[目次へ]

コードブロック

標準 Markdown では 4 文字分インデントするとコードブロックになりますが、 拡張 Markdown では ~~~ で囲むとコードブロックになります。

また、言語の指定もできます。
↓エスケープの仕方がわからなかったので先頭にスペース文字をいれています。

 ~~~ Markdown
* 目次(この要素は HTML として出力されません)
{.toc}
~~~ 

コードブロックは Google Code Prettify や highlight.js で自動的にハイライトすることができるようです5。

追記: どのエンジンも MarsEdit で HTML に変換すると改行が削除されてしまうようです。

[目次へ]

各 Markdown エンジンの対応状況

拡張内容MarukuRDiscountKramdownRedcarpet
Inline HTML * * * *
Markdown Inside HTML Blocks * - * -
Header Id Attribute * - * -
Fenced Code Blocks *6 *7 * *8
Tables * * * *
Definition Lists * - * -
Footnotes *9 - * -
Abbreviations * - * -
Emphasis -10 * * *
Backslash Escapes * - * *
  • *: 対応
  • -: 非対応
  • Redcarpet はオプションの指定が必要

本エントリで言及していないものについては PHP Markdown Extra をご確認ください。

上記を見ると、Kramdown がよさそうです。

Kramdown は HTML から Markdown への変換もできるようです。 まだ試していませんが、公開済みのエントリを Markdown に変換して編集し、再度 HTML に変換してサーバにアップロードするという使い方ができるかもしれませんね。

[目次へ]

MarsEdit の設定

Markdown エンジンのインストール

Markdown エンジンは gem コマンドでインストールすることができます。 環境によっては gem のアップデートを先に実行する必要があります。

$ sudo gem update --system
$ sudo gem install kramdown 

Text Filter の追加

$HOME/Library/Application Support/MarsEdit/TextFilters にフィルタ名のディレクトリを作成し、シェルスクリプトを作成します11。

Library/Application\ Support/MarsEdit/TextFilters/
 ├── Convert\ Line\ Breaks_1.1.3
 │   └── Convert\ Line\ Breaks.py
 ├── Markdown_1.0
 │   ├── License.text
 │   ├── Markdown\ Readme.text
 │   └── Markdown.pl
 ├── SmartyPants_1.5.1
 │   ├── SmartyPants\ Readme.txt
 │   └── SmartyPants.pl
 ├── Textile_1.0
 │   ├── Text
 │   │   └── Textile.pm
 │   └── Textile.pl
 ├── kramdown
 │   └── kramdown.sh
 ├── maruku
 │   └── maruku.sh
 ├── rdiscount
 │   └── rdiscount.sh
 └── redcarpet
     └── redcarpet.sh 

Redcarpet の例は以下の通りです。

#! /bin/sh
CMD=redcarpet
CMDARGS="--parse-no_intra_emphasis --parse-tables --parse-fenced_code_blocks --parse-autolink --parse-strikethrough --parse-superscript --render-with_toc_data"
$CMD $CMDARGS $1 

MarsEdit でプレビューフィルタによる Markdown の使い方についは 以下をご覧ください。

[目次へ]


  1. メモには使っています。↩

  2. 本エントリは Kramdown で HTML に変換してポストしました。↩

  3. セル内が複数行になるようなものは書けないみたいですね。↩

  4. 私が試してみたところ Maruku では目次の自動生成がされませんでした。↩

  5. 別途組み込みが必要です。↩

  6. ~~~ ではなく ```↩

  7. ~~~ ではなく ```↩

  8. ~~~ と ``` のどちらも OK↩

  9. 脚注の前に水平線が挿入される↩

  10. 単語の間に _ があると強調にならないようです。↩

  11. シェルスクリプトである必要はありません。↩

[iOS] #MyScripts で Markdown記法を HTML に変換 - フロントエンドは DraftPad で

このエントリーをはてなブックマークに追加 Pocket

@hitoriblog さんに導かれて、MyScripts を触り始めた @toshiya240 です。

MyScripts 1.0 (¥350)App
カテゴリ: 仕事効率化, ユーティリティ
販売元: Unit Kay - Takeyoshi Nakayama(サイズ: 0 MB)
全てのバージョンの評価: (4件の評価)
+ iPhone/iPadの両方に対応

参考:

手始めに Markdown記法を HTML に変換するスクリプトを作ってみました。

Markdown記法については以下をご覧ください。

今回は MyScripts のアーキテクチャを理解することを目的としましたので、変換エンジンには上記のエントリに記載した Showdown を使用しました。自分で書いたコードはちょっぴりです。

インストール

iPhone/iPad で以下のリンクをそれぞれタップして、MyScripts/DraftPad で保存してください。

2012-01-30 追記
Showdown の Copyright をスクリプトに追記しました。 ライセンス条件として要求されているためです。

デモ

▼ Showdown のサンプルで試してみましょうか。
IMG_0438.png

▼ アシストを起動すると、MyScripts に遷移して、そのまま DraftPad に返ってきます。
IMG_0440.png

▼ Markdown 記法が HTML に変換されました。
IMG_0441.png

▼ HTML プレビューしてみる。( ゚д゚)ウム
IMG_0442.png

▼ 変換前の内容は DraftPad の履歴に残るので、修正してやり直しもできます。
IMG_0443.png

あとがき

本エントリは iPhone で今回のスクリプトと PictShare/PicasaHtml を使って書こうと頑張ってみましたが、 慣れていないせいかミョーに時間がかかるので挫折しました(´Д⊂ヽ

iPhone でブログを書く環境をもうちょっと整えて修行します。

しかし、MyScripts 面白いです。まだまだいろんな可能性がある気がします。

MyScripts 1.0 (¥350)App
カテゴリ: 仕事効率化, ユーティリティ
販売元: Unit Kay - Takeyoshi Nakayama(サイズ: 0 MB)
全てのバージョンの評価: (4件の評価)
+ iPhone/iPadの両方に対応

PictShare - multiple photos/movies uploader 2.6.2 (¥250)App
カテゴリ: ソーシャルネットワーキング, 写真/ビデオ
販売元: itok - 啓 Ito(サイズ: 3 MB)
全てのバージョンの評価: (155件の評価)

[MarsEdit] Markdown 記法でブログを書く

このエントリーをはてなブックマークに追加 Pocket

もともとは @fujimotta さんに教えてもらったんですが、先日 MarsEdit まとめを書く際にやはり便利でしたのでエントリしておきます。

Markdown 記法って?

Markdown 記法ってご存知でしょうか。

以前、Markdown 記法で HTML と疎遠になる という記事を書いたのですが、Markdown 記法についてはあまりに手抜きをしていたのでここでまとめておきます。

Markdown - Wikipedia
Markdown(マークダウン)は軽量マークアップ言語の1つである。入力する形式と出力される形式の両方について、読みやすさと「発行のしやすさ (publishability)」の最大化を支援することを目的として、John GruberとAaron Swartzによって作成された。

私は以下のように考えています。

Happy-Go-Lucky: Markdown 記法で HTML と疎遠になる
Markdown 記法を用いることで、以下のメリットが得られると私は考えます。
  • 素早く書ける
  • 編集しているテキストが見やすい

ここでは Markdown 記法のすべてを説明することはせず、私がよく使用するものに限定して説明します。

見出し

見出しは以下のように書くことができます。

# 見出し1(h1)
## 見出し2(h2)
### 見出し3(h3)
#### 見出し4(h4)
##### 見出し5(h5)
###### 見出し6(h6)

引用

引用はメール的です。

> Markdown(マークダウン)は軽量マークアップ言語の1つである。
> 入力する形式と出力される形式の両方について、読みやすさと
> 「発行のしやすさ (publishability)」の最大化を支援することを目的として、
> John GruberとAaron Swartzによって作成された。

箇条書き

番号なし(ul)の書き方は以下の通りです。

* 素早く書ける
* 編集しているテキストが見やすい

'+' や '-' を使うこともできます。

番号つき(ol)の書き方は以下の通りです。

1. はじめに
2. つぎに
3. さいごに

'番号.' の後ろにはスペースが必要です。

リストの中に段落や引用を含めたい場合は、空行を入れた上で行頭に 4 つのスペースまたはタブ文字を入れます。

1. はじめに

    本エントリでは。。。
    > Markdown とは、。。。

2. つぎに
3. さいごに

リンク

リンクの書式は以下の通りです。

[<リンクテキスト>](<リンクURL><リンクタイトル>)

私の場合、リンクを Markdown で書くことはそれほど多くありません。 リンクはブックマークレットやプラグインで生成することがほとんどだからです。

Markdown 記法には他にも水平線や画像リンク、テキストの装飾などがありますが、ここでの紹介は割愛します。

参考

MarsEdit で Markdown

MarsEdit で Markdown を利用するには、以下の方法しかないと思っていました。

  1. Showdown - Markdown in Javascript で HTML に変換して MarsEdit のエディタに貼り付ける。
  2. WordPress の PHP Markdown プラグインを使用するなどしてブログシステム側で Markdown が変換されるようにする。 Tumbler と Posterous はもともと Markdown をサポートしています。 →Markdown 記法で HTML と疎遠になる

そこで出会ったのが以下の記事です。

想造ノート: あれ、もしかしてMarsEditってMarkdown記法できるんじゃね?

でもって、以下の会話で教えていただきました。

@sozonote プレビューのフィルタはありますよ〜。でも、残念ながら Blogger ではそのまま投稿してもダメです。Tue Apr 13 01:32:29 via TweetList Pro

@toshiya240 一旦RichTextModeに切り替えてやると変換してくれるかもです!Shift+Command+Tです!Tue Apr 13 06:57:40 via Twitter for iPhone

そう、MarsEdit だけで Markdown を HTML に変換することができるのです!

ということで手順です。

プレビューフィルタを Markdown に設定する

▼メニューの [Blog] > [Edit Settings...] からブログの設定画面を表示してください。 [Editing] タブの [Preview Text Filter] を「Markdown」にして [OK] ボタンをクリックします。 MarsEditPreviewFilterSetting

プレビューフィルタを設定することで、エディタに Markdown 記法で書くと該当する HTML を書いたかのようにプレビューに表示されます。

Markdown のサンプルPreview of  Markdown のサンプル

Markdown 記法で記事を書く

▼こんな感じで書いていきます。 MarsEditWritingWithMarkdown 1

Markdown から HTML に変換する

書き終わったら、おもむろに

⌘ + ⇧ + T

です!

▼こんな画面が表示されるので、[Convert] ボタンをクリックしてください。 MarsEditMessage

HTML への変換結果をチェックする

もう一度

⌘ + ⇧ + T

を押して、HTML 編集モードに戻します。

▼ [Convert] ボタンをクリックしてください。 MarsEditMessage2

多分、意図していない HTML になっている部分があるはずですw

ポスト

チェックが終わったらポストしましょう。

さいごに

Markdown のメリットについてもう一度引用します。

Happy-Go-Lucky: Markdown 記法で HTML と疎遠になる
Markdown 記法を用いることで、以下のメリットが得られると私は考えます。
  • 素早く書ける
  • 編集しているテキストが見やすい

と言っても、適材適所で使い分けるのが実際的だと思います。

あ。そうそう。プレビューに出来上がりイメージが表示されるので、HTML に変換しないままポストしてしまうことが私にはありました。要注意ですw