Markdown を拡張する MDX はドキュメント作成の新たな可能性？
この記事は、技術書典 11 で頒布中の「Vivliostyle で本を作ろう vol. 5」から抜粋した記事です。ご興味ありましたら、Vivliostyle を使って組版された本誌もぜひお買い求めください！ また、この記事以外の内容もすべて Vivliostyle 公式サイトで無料公開中です。 技術書やドキュメントを執筆する際、あなたはどのような形式で文章を書きますか？ 最近ではもっぱら Markdown で書かれることが多いですが、この Markdown を拡張するポテンシャルを持つお気に入りの OSS プロジェクト「MDX」を紹介します。 MDX = Markdown + JSX MDX の名前の由来は Markdown + JSX なので、MDX を理解するためにはまず JSX について知る必要があります。 JSX とは JavaScript の拡張構文の一つで、元々 React の
gihyo.jp編集部におけるMarkdown記法 | gihyo.jp
本稿では、gihyo.jp編集部で利用しているMarkdownファイルの記述方法を主に解説します。 注意：gihyo.jp編集部内でのみ採用しているMarkdownの書き方をまとめた文書を、記事の体裁を取って公開したものです。なお、記事公開後に記述方法を追加・変更する可能性もあります。 Markdownとは？ はじめに、筆者の把握している範囲でMarkdownについて概説しておきます。 近年は一般向けのウェブサービスやテキストエディタでも利用されてきているMarkdown。端的に言えば、テキストファイル上で文書を書くための構文です。文書の読みやすさに焦点を当てており、Markdown形式のテキストファイル（＝Markdownファイル）をそのまま見れば文書とその構造が理解できるように、Markdown特有の編集記号や字下げを用いて表現します。また、MarkdownファイルをHTMLファイルに
Fuzoku実践入門ブログ
先日、発売を開始した英語版『Fuzoku実践入門』こと『Fuzoku: The Complete Guide to Sex Industry in Japan』ですが、出版を記念して無料セールを開始しました。 日本語版をお持ちの方も、そうでない方も、ぜひ英語の勉強がてらダウンロードしてみて下さい。 そして、外国人の知り合いがいる人は、ぜひオススメして下さい。 .com アカウントをお持ちの方へ ちなみにもし、amazon.comのアカウントをお持ちの方は、 http://www.amazon.com/dp/B00VF5J0BY こちらの amazon.comの販売ページからダウンロードしていただけると、とても嬉しいです。 どうぞ宜しくお願いします。 かねてからの予定通り、無事に英語版『Fuzoku実践入門』となるが無事に発売されましたので、お知らせ致します（ただし、英語版の登録にあたり、サ
Standard Markdown
What is Markdown? Markdown is a plain text format for writing structured documents, based on conventions used for indicating formatting in email and usenet posts. It was developed in 2004 by John Gruber, who wrote the first markdown-to-html converter in Perl, and it soon became widely used in websites. by 2014 there were dozens of implementations in many languages. Digital data in any form needs p
RedPen を公開しました (ベータバージョン) - Advanced Technology Lab
はじめまして、ATL でソフトウェアエンジニアをやっている伊藤 (@takahi_i) です。この度 RedPen という自然言語で書かれた文書のチェックツールをベータ公開しました (ベータバージョンでの告知となってしまい恐縮です)。本ツールが対象とする自然言語で書かれた文書としては、マニュアル、論文、E-メールなどがあります。以下プロジェクトの URL となります。 http://redpen.cc 本稿では RedPen の機能と使い方について紹介します。 RedPen の機能 RedPen は文書内で使用されている表現の非統一や、読みにくい文、あきらかな不整合を見つけ警告を出力します。現在提供されているのは、以下のように非常にプリミティブな機能です。 文長、パラグラフ長 不正な表現 不正なシンボル カタカナの終了ハイフンの有無 カタカナのスペルチェック シンボル前後のスペース 現在プ
Markdownファイルを使ったWiki風システム·PHDoc MOONGIFT
PHDocはPython製のオープンソース・ソフトウェア（MIT License）です。 Wikiエンジンの大きな欠点とも言えるのが編集時のテキストエリアが平凡すぎて編集が面倒ということです。そこでPHDocではMarkdownファイルを共通フォーマットにし、編集はテキストエディタを使う方式を採用しています。 メインページです。普通にMarkdownとして書けます。 式を入れる事もできます。 自由にページを作成できます。日本語ももちろん使えます。 PHDocはPython製のコマンドで、自由にMarkdownフォーマットでファイルを作成したり記述した後、phdoc buildコマンドでHTMLファイルを生成します。その後phdoc serveコマンドでWebサーバが立ち上がってコンテンツが閲覧できる形です。Wikiとは違う気もしますが、使い慣れたテキストエディタでコンテンツが作成できるのは
Markdown - Wikipedia
Markdown（マークダウン）とは、文書を記述する軽量マークアップ言語である。プレーンテキスト形式で手軽に書いた文書からHTMLを生成するために開発されたが、PowerPoint形式やLaTeX形式のファイルへ変換するソフトウェア（コンバータ）も開発されている。各コンバータの開発者によって拡張が施された各種の方言が存在する。 「書きやすくて読みやすいプレーンテキストとして記述した文書を、妥当なXHTML（もしくはHTML）文書へと変換できるフォーマット」として、ジョン・グルーバー（英語版）により作成された。アーロン・スワーツも大きな貢献をしている[4]。Markdownの記法の多くは、電子メールにおいてプレーンテキストを装飾する際の慣習から着想を得ている。 Markdownはグルーバーによって書かれたMarkdown.plというPerlプログラムを指すこともある。このスクリプトは、Mar
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
