Show HN: SmallDocs – フラストレーションのない Markdown の導入方法

2026/04/15 20:29

Show HN: SmallDocs – フラストレーションのない Markdown の導入方法

RSS: https://news.ycombinator.com/rss

要約

Japanese Translation:

SmallDocs は、コマンドラインエージェントが生成する

.md
ファイルの閲覧と共有における課題を解決するために作られた、プライバシーを最優先とした CLI および Web アプリケーションツールです。100% のローカル制御でマダックファイルを即座にプレビューして共有できるように設計されています。
sdocs-dev
をインストールすると、
sdoc path/to/file.md
を実行することでブラウザ上でファイルを開くことができ、本ツールは単なるクライアントサイドレンダリングエンジンとして機能します。コンテンツは URL フラグメント内に圧縮された Base64 データとして保存されるため、デバイス外へ送出されず、リモートサーバーとも接しません。ユーザーは各ファイルの YAML Front Matter の先頭で複雑なスタイルやグラフのレンダリングを指定でき、共有された URL に沿ってセキュリティを保ったままスタイルと可視化データを安全に伝搬させることができます。SmallDocs は、ローカルエージェントファイル(例:
~/.claude/CLAUDE.md
または
~/.codex/AGENTS.md
)に構成行を追加してエージェントワークフローへの統合を促しており、CLI の初期使用時にこれらの行を自動追加するためのオプションのセットアップフェーズも用意されています。
sdoc schema
sdoc charts
といったコマンドでさらなる機能や冒険的な例題にアクセスでき、ドキュメントの詳細は CLI を介して入手可能です。今後の展望として、SmallDocs はプリスタイルされた文書の安全な共有を簡素化し、将来のワークフローにおけるマダックコンテンツのレンダリング方法を変革することを目標としています。

本文

こんにちは、HN の方々。SmallDocs (https://sdocs.dev) をご紹介します。SDocs は、コマンドラインインターフェース(CLI)とウェブアプリケーションを組み合わせたツールで、マークダウンファイルの内容を瞬時に、かつ完全にプライベートな形でエレガントにプレビューおよび共有可能にします。(ソースコード:GitHub リポジトリ

コマンドラインベースのエージェントとの作業が増えるに従って、

.md
ファイルは私たちの日常業務の一部になりつつあります。エージェントによる出力としては優れていますが見る方(人間)にとっては少々不便で、プレビューや共有・受領がやや面倒な面があります。SDocs はこうした課題を解決することを目的として開発されました。

まず

npm i -g sdocs-dev
でグローバルにインストールした後、以下のようにコマンドを実行すると、ブラウザで即座にプレビュー表示されます(見た目にも心地よいデフォルトスタイルを適用済み)。
sdoc path/to/file.md

さらに、生成された URL は瞬時に共有可能です。

私たちのエージェントが生成する

.md
ファイルには、コードベースに関する情報や未解決のバグ、本番環境のログなど、極めて機微な情報が含まれています。そのため、SDocs では「100% のプライバシー」を必須要件として位置づけています。

このために、SDocs の URL フラグメント(# の直後の部分)に、圧縮された Base64 エンコード形式でマークダウンドキュメントの内容が埋め込まれています。 例:

https://sdocs.dev/#md=GzcFAMT...
(この部分は文書内容そのものです)。

URL フラグメントの優れた点は、サーバーには送信されないという事実にあります(Mozilla のドキュメントをご覧ください:「フラグメントは URI を要求する際にサーバーへ送られず、クライアント側で処理される」)。

sdocs.dev のウェブアプリは、単に URL フラグメントに格納されたコンテンツをクライアント側でデコードしてレンダリングするエンジンに過ぎません。つまり、ドキュメントの内容はあなた自身と、共有先を選択した相手の方の側に留まり、SDocs サーバーは一切アクセスすることなく扱われます。(ご自身の環境で、あるいはエージェントから当社のコードを検証してみていただければ、これは容易に確認できます)

.md
ファイルは今後の働き方において大きな役割を果たす可能性を秘めているため、SDocs はマークダウン形式でのコンテンツの表示やスタイル付けにおける境界線を押し広げたいと考えています。まだ多くの作業が残されていますが、まずは複雑なスタイルを追加したり、チャートを可視化してレンダリングしたりといった機能を既に実装しています。SDocs のルートディレクトリにある
sdoc.md
をデフォルトスタイルで表示するページには、冒険的な試みに関するいくつかの画像とリンクを掲載しています。「sdoc schema」と「sdoc charts」コマンドは、SDocs フォーマティングを最大限に活用するための詳細な情報をご提供します。

また、共有された SDocs URL に合わせてスタイルが同行するのは、マークダウンファイルに Jekyll ドキュメント方式に基づく YAML フロントマターとしてスタイル設定を追加しているためです(例:https://jekyllrb.com/docs/front-matter/)。

---
styles:
  fontFamily: Lora
  baseFontSize: 17
  ...
---

業務の現場では、実際にこのプロジェクトのテストを行っています。私とチームメンバーは、SDocs をエージェントによるデバッグレポートの共有や、Claude から容易にコピペ可能なコンテンツ(例えば一連の実行が必要なバッチコマンドなど)を取得する手段として非常に有用だと感じています。

また、私たちのエージェントが SDocs を積極的に利用できるよう促すため、ルートディレクトリの「エージェントファイル」(例:

~/.claude/CLAUDE.md
~/.codex/AGENTS.md
など)に数行の指示文を追加しています。CLI を初めて使用する際に、この設定作業を支援するためのオプションセットアップフェーズを用意しています。

もちろん、皆様からのフィードバックは大いに歓迎しており、SDocs に機能を追加したいという方はプルリクエストを大歓迎します。

ご覧いただけたことをありがとうございます!

同じ日のほかのニュース

一覧に戻る →

2026/04/19 5:54

『好みの色を選べる:NIST の科学家らが、任意の波長のレーザーを開発』

## Japanese Translation: NIST の科学者と協力者が、Scott Papp という NIST の物理学者をリーダーとして発表された「Monolithic 3D integration of tantalum pentoxide nonlinear photonics」という論文に詳述されているように、特殊な材料の複雑なパターンをシリコンウエハーに堆積させることで、統合光子デバイスのチップ作成における画期的手法を開発しました。この革新は、サイズ、コスト、電力に関する重要な歴史的制約を解決し、量子コンピューティングなどの高度な技術用のコンパクトで高品質なレーザーの実現を可能にします。酸化シリコン、リチウムニオブате、タンタル五酸化物(単一のレーザー色を多様な波長に変換しつつ過度の発熱を抑える材料)を含むマルチレイヤーアプローチを用いることで、チームはビールコスター程度のサイズのパターンに、約 10,000 の光子回路を備えた指先ほどの大きさのチップを約 50 個集積することに成功しました。以前是高品質なレーザーは特定の波長(例:980 nm の赤外線)のみに存在し、量子技術の利用が専門的な研究室に限定されていましたが、この画期的進展により、携帯型光原子時計や地震予測システムといった現場での応用が可能になります。光原子時計や量子コンピュータなどの量子技術には、ルビジウム(780 nm の赤)やストロンチウム(461 nm の青)など、異なる原子に合わせた特定の色のレーザーが多く必要とされますが、この新技術はそれを効果的に解決します。この技術は、効率的な光処理を必要とする産業において量子デバイスへのアクセスを民主化するだけでなく、研究機関と Octave Photonics などのスタートアップ間の協力を促進します。*Nature* に掲載されたこれらの発見は、光子機能と電気システムを統合する道を開き、人工知能から暗物質調査に至るまでの分野を変革する可能性があります。これにより、複雑な科学ツールが従来の実験室の外でも手頃な価格で利用できるようになります。

2026/04/19 1:26

ボーイング社の B-52 ストラトフォートレス爆撃機に搭載された、スタートラッカー内の電気式傾斜計。

## Japanese 翻訳: アストロコンパスは、1960 年代の B-52 爆撃機向けに開発され、乗組員が手動で行っていた複雑な三角法の計算を自動化し、天体航法を画期的に変化させました。ジャミングに脆弱な現代デジタルシステムと異なり、この電気機械装置は、外部デジタル信号を使用せずに、シンクロン(変送機)および光増倍管を用いて恒星を追跡する信頼性の高い抗ジャミング方式を提供しました。恒星位置の物理的な追跡と天球のアナログモデルを組み合わせることで、システムはパイロットにリアルタイムでの航法更新を通じて正確な位置を決定することを可能にしました。 公式空軍年誌からのデータに基づいて動作し、この装置は時間や恒星の赤緯などの入力をノブで調整するマスターコントロールパネルを搭載していました。これらの設定は、安定したジャイロプラットフォームとガラスドーム型望遠鏡を含む組立体内の 19 のコンポーネントを駆動しました。アストロコンパスは「位置線」技術を使用し、測定された恒星の高度を計算された期待値と比較することで航空機の軌跡を特定しました。この自動化により、困難な手動手順はスムーズな電気機械プロセスへと変換され、爆撃機艦隊が重要な航法任務において、作戦能力とミッション安全性を大幅に向上させました。

2026/04/19 4:19

Claude のデザインに関する考察と感情

## 日本語翻訳: 要約:中心的な論点是、Figma の専用でロックされたファイル形式がネイティブのスキーマを持たず、深いエイリアシングおよび未文書化されたプリミティブに依存を迫られること(例:946 色の変数を含むネストされたグループのあるファイル)であり、これがコードトレーニング済みの AI モデルが設計論理を正確に解釈することを妨げる。LLM はこれらの特定の不透明な Figma 構造ではなくコードに対してトレーニングされているため、「Figma Make」のような現在のツールは、設計ファイルが依然として規範的であると示唆することでユーザーを誤導し、実質的にワークフローを新しいエージェント時代と不相容の専用エコシステムにロックしている。その対応として、Claude Design とような新たなツールは、「HTML と JS をすべて徹底する」というアプローチを取り、コードと直接統合してレポジトリから AI エージェントへ供給される統一されたフィードバックループを創出する。著者は業界における分岐の予測を行う:一方は誠実なコード連結による生産ツールへの道筋、他方は Photoshop に似た制約のない探求環境への道筋となる。クリーンなコードからのこの転換を批判しつつも、著者は Sketch などの競合業者に対してネイティブ機能に安住するのではなく、粒子エフェクトやメッシュ変換などの特定機能を備えた革新を促し、Figma の形式が AI エージェントに必要なトレーニングデータへの含まれにくさを指摘している。 ## テキストを翻訳 (必要に応じて;そうでない場合は元のものを繰り返す): ## Summary: The core argument is that Figma's proprietary, locked-down file format lacks a native schema, forcing reliance on deep aliasing and undocumented primitives (exemplified by files containing 946 color variables within nested groups) that prevent code-trained AI models from accurately interpreting design logic. Because LLMs were trained on code rather than these specific, opaque Figma structures, current tools like "Figma Make" are misleading users by suggesting the design file remains canonical, effectively locking workflows into a proprietary ecosystem incompatible with the emerging agentic era. In response, new tools like Claude Design adopt an "HTML and JS all the way down" approach, integrating directly with code to create a unified feedback loop where repositories feed AI agents. The author predicts a fork in the industry: one path toward honest, code-linked production tools, and another for unconstrained exploration environments similar to Photoshop. While criticizing this shift away from clean code, the author also urges competitors like Sketch to innovate with specific features (particle effects, mesh transforms) rather than resting on native capabilities, noting that Figma's format prevents its inclusion in necessary training data for AI agents.