問題タブ [markdown]

基本的なリクエストは次のとおりです。

• 人間が読める / テキスト形式 (簡単なバージョン管理のため)
• オンライン（コラボレーション用）
• 簡単な書式設定 (マークダウンはOK、html は多すぎる)
• 厳密な書式設定 (作成者が新しいタイプのタイトル、箇条書きなどを発明しないようにするため)
• PDF、HTMLにエクスポート可能
• 簡単なバックアップと展開 (読み取り専用バージョンとしてお客様のサイトに「展開」できるようにするため)

ある種の wiki エンジンを使用することを考えていますが、ストレージにファイルを使用するか、顧客への「展開」の他の手段が必要であり、インストール/メンテナンスが簡単である必要があります。また、無料/安価である必要があります（合流点は高すぎます）

助言がありますか？

編集: コードを文書化するためのツールを探しているわけではありません。Sandcastle を使用してカバーしています。

ウィキが認められるような会社ではないので、アウトルックでのコミュニケーションが多いです。それを介してコードスニペットを送信するのは苦痛です。ここにあるマークダウンを取得する方法はありますか？

Web ベースのアプリケーションを開発していて、リッチ フォーマットのテキストをユーザーに許可したい場合、その入力を許可する方法を選択する必要があります。HTML のサニタイズは間違いなく難しいため、さまざまなマークアップ言語が作成されています。

次のようなさまざまなマークアップ言語の長所と短所は何ですか。

• HTML
• マークダウン
• BBコード
• 繊維
• MediaWiki マークアップ
• 他の

別の言い方をすれば、特定のマークアップ言語を使用する際にどのような要因を考慮しますか。

通常、マークダウン ドキュメントには .markdown または .md 拡張子を使用します。残念ながら、ファイル拡張子が .txt でない限り、spotlight はそれらのインデックスを作成することを拒否します。

textmate ブログでInfo.plist ファイルを編集することによる解決策を見てきました。より良い方法はありますか？

更新:スポットライト サポートと素敵な HTML クイックルック プレビューを追加する、Markdown ファイル用の QuickLook ジェネレーターを発見しました。それは御馳走になります！

rakefile で使用できるマークダウン インタープリター クラス/モジュールを探しています。

これまでのところmarukuを見つけましたが、ベータ版のリリースには少し警戒しています。

マルクで困ったことある人いますか？または、より良い代替手段を知っていますか?

私はスタック オーバーフローのコメント UI がとても気に入っています。同じことを自分の Web サイトに実装することを検討しています。コードを調べたところ、ここでの主なツールはWMDであり、JQuery TextArea Resizerが補助的な役割を果たしているようです。

WMD は、クライアント側で Markdown を HTML に変換します。プレビューに役立つのでとてもいいのですが、それをサーバーに送信するときに問題が発生します。検証エラーが発生した場合 (たとえば、ユーザーがコメント フォームの他の部分に無効な電子メール アドレスを入力したか、名前を入力しなかったなど)、サーバーはエラー メッセージを含むフォームを再表示して応答します。フォーム フィールドは事前入力されています。サーバーが Markdown を見たことがないため、コメント テキストは Markdown ではなく HTML になりました。しかし、それはユーザーが入力していたものなので、Markdown にしたいと思います。

ここに何かアイデアはありますか？

私はさまざまなアイデアを検討しました：

• サーバー側でHTML から Markdown への変換を行います。このアイデアについてはそれほど興奮していません。Markdown から HTML を再び Markdown に変換するのはばかげているように思えます。ユーザーとして、ソフトウェアがテキスト/コードを再フォーマットするときはいつもイライラします。
• クライアント側の検証 (もちろん保持するサーバー側の検証を強化するため)。現在、コメントフォームでreCAPTCHAを使用していますが、合理的な方向のように思えます。つまり、少なくともreCAPTCHA部分をサーバーに投稿する必要があります。
• WMD を失い、MarkdownJ を使用してサーバー上で Markdown を HTML に変換します。プレビュー機能を実現するための他のメカニズムを探す必要がありますが、これは維持したいと考えています。

理想的には、テキストの Markdown バージョンを取得し、それを HTML に加えてサーバーに送信する方法があればよいのですが、それが実際に可能かどうかを知るには、私は JavaScript の専門家ではありません。

任意の提案をいただければ幸いです。

コンテンツがマークダウンで書かれているRailsサイトがあります。「続きを読む..」リンクを使用して、それぞれのスニペットを表示したいと思います。

どうすればいいですか？たとえば、生のテキストの単純な切り捨ては機能しません..

理想的には、作成者が（オプションで）マーカーを挿入して「スニペット」として使用するものを指定できるようにしたいのですが、そうでない場合は250語かかり、「...」を追加します-たとえば..

マーカーは EOF マーカーのように考えることができます (完全なドキュメントを表示するときは無視できます)。

Markdown 処理にmarukuを使用しています (RedCloth は Textile に非常に偏っており、BlueCloth は非常にバグが多く、peg-markdown と RDiscount を除外するネイティブ Ruby パーサーが必要でした)。

あるいは (とにかく Markdown は HTML に変換されるため)、HTML を正しく切り捨てることもオプションです。ただしmarkdown()、最初の数行を取得するためだけに、ドキュメント全体ではなく、それが望ましいでしょう。

だから、私が考えることができるオプションは（好みの順序で）..

• maruku パーサーに "truncate" オプションを追加します。これは、最初の x 個の単語のみを解析するか、"excerpt" マーカーまで解析します。
• パーサーに依存しない Markdown truncate'r を書く/見つける
• インテリジェントな HTML 切り捨て関数を書く/見つける

.NETでマークダウンをhtmlに変換するにはどうすればよいですか?

表示時に HTML に変換する必要があるデータベースに保存されている Markdown テキストがあります。

StackOverflow のWMD Editor (現在はPageDown )については知っていますが、それはクライアント側のみを変換します。

私はちょっとした wiki を書いていて、構文の強調表示のすべてのオプションを調べています。ウィキ構文 (mediawiki) とマークダウン + ホワイトリストに登録されたタグの間の議論。私は後者を好むと思いますが、ユーザーにはテーブルが必要だと思います。ここ Stackoverflow でテーブルが許可されていないのはなぜですか?

ウィキやマークダウンなど、ユーザーが入力したマークアップを処理する際に役に立ったアドバイス。CPU とデータベース スペースの両方のコストがかかるため、どちらに行けばよいかわかりません。

1. マークアップをデータベースに保存し、ページビューごとにサーバーで html にレンダリングします。(データベース容量は少なくなりますが、CPU 使用率は高くなります)

2. マークアップをデータベースに保存し、javascript を使用してクライアントで HTML にレンダリングします。(実装は難しいかもしれません)

3. レンダリングされた html だけをデータベースに保存し、編集が必要な場合はマークアップに戻します。(繰り返しますが、実装が難しい可能性があります)。

4. HTML とマークアップの両方をデータベースに保存します。(データベース スペースを 2 倍にします)。

5. 他の何か。

(私は MFC と Linqtosql を使用しています)。