I've used many content formats over the years, and while I loveMarkdown, I run intoits limitations daily when I work on larger documentation projects. In this issue, you'll look atMarkdown and explore whyit might not be the best fit fortechnical content, and what else might work instead.Markdown Lacks the Structure You NeedMarkdown is everywhere.It's human-readable, approachable, and has j

はじめにObsidianでは主に2つのリンク形式を使うことができます。 Wikilink形式:[[ノート名]] や [[ノート名|表示テキスト]]Markdownリンク形式:[表示テキスト](ノート名.md) Wikilink形式はObsidianで使えるファイルリンクの記法で、書きやすく読みやすいのが特徴です。 一方、Markdownリンク形式は標準的なMarkdown記法なので、他のツールでも扱いやすいという利点があります。 しかし、一度どちらかの形式で書き始めると、後から変更するのは大変です。特に大量のノートがある場合、手動での変換は現実的ではありません。 ツールの移行や心境の変化でもう一方の形式に変更したくなったときのために、2つの形式を相互変換できるCLIツールを作成しました。 リポジトリ インストール方法 きっかけObsidianを使い始めた当初はWikilink形式を使

はじめに 最近Markdown を触る機会、増えてますよね。AI ツールの登場で、書いたり読んだりレビューしたりが日常的になってきました。 特に最近は Kiro なんかの登場もあり、Markdown がワークフローの中心になっている人も多いかと思います。 ただ、ローカルに溜まっていく .md ファイルを 読む 体験には、あまり選択肢がありませんでした。 エディタで1ファイルずつ開くのは面倒だし、ツリー構造を見ながら全体を把握したいときにも不便です。 そこで今回 mdts を作りました。 ローカルにあるMarkdown ファイル群を、 npx mdts のみでツリー構造のままブラウザで閲覧できるようなCLIツールです。 特徴 ⚡ 1コマンドで即起動 npx mdts を叩くだけで現在のディレクトリをブラウズ可能。 🌐 ブラウザベース 専用アプリ不要。Web ブラウザでそのまま閲覧可能

はじめにZennのようなブログ記事やAstroなどの静的サイトジェネレーターが、どのようにMarkdownを受け取り、ドキュメントを生成しているのか。 その仕組みに強い関心を抱いた私はAstroの Content Collections のソースコードを読み始めました。とりわけ印象的だったのは、フロントマターを抽出する gray-matter でメタデータを取り出しつつ、本文をunifiedパイプラインへ流し込む一連の設計です。 この記事では、そうした実装を眺めた好奇心から始まり、多重パース時代の課題、ASTリレーがもたらした転換点やMDX 3・WASM・Edgeが広げる近未来までを、コードと図を交えながら俯瞰します。 第一世代:多重パース時代Markdown変換ライブラリの草創期を支えたmarkdown-it や marked は、Markdown →HTML文字列 を1回だけ高

Amazonの商品紹介Markdownをつくるブックマークレット作成日:2024年8月23日更新日:2024年8月23日 このサイトはObsidianで管理しているノートをQuartzで公開しており、全てのテキストはMarkdownで書いている。 このため、Amazonの商品紹介をするのがなかなか面倒であり、これを改善するためのブックマークレットを書いた。 使い方Amazonの商品ページに行ってこのブックマークレットを起動すると、以下のようなMarkdownが生成され、クリップボードへコピーされる。 ![[オン] ランニングシューズ Cloudmonster メンズ](https://a.media-amazon.com/images/I/51lG1xvL7nL._AC_SY200_.jpg) [[オン] ランニングシューズ Cloudmonster メンズ](https://www.a
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? 2024年のアドベントカレンダーで、マークダウン記法で記述して簡単にウェブサイトやアプリが作れるMarkdownAIというサービスを知りました。 そこで、お出かけ先でもスマホで楽しめる子ども向け動物園アプリをMarkdownAIで試作してみました。 作ったもの「MarkdownAI動物園」 今回作成したのは「MarkdownAI動物園」というスマホで使える、簡単なアプリケーションです。 以下のリンクから実際にアプリを使えるのでぜひ試してみてください。MarkdownAI動物園 ※スマホで使う想定のため、PCだと見づらい部分があります

「Markwhen」はマークダウンに似た記法で予定表を作り、タイムライン形式やカレンダー形式で表示できるシステムです。一般的なカレンダーアプリではボタンを1つ1つクリックしながら予定を登録する必要がありますが、Markwhenならテキストをダダダッと打ち込むだけで予定を登録できます。 Markwhen https://markwhen.com/ MarkwhenはVisual Studio Code(VS Code)やObsidian向けの拡張機能として利用可能なほか、簡単に使えるウェブアプリ「Meridiem」も用意されています。今回は以下のリンク先にアクセスしてMeridiem上でMarkwhenを使ってみます。 Meridiem https://meridiem.markwhen.com/ Meridiemの画面はこんな感じ。画面中央にMarkwhen形式のテキストが表示され、右側に

はじめにフューチャー技術ブログのリレー形式の連載である、春の入門祭り2023の1日目です。TIG真野です。 ここ数年、Markdownで設計書をチームで書き、GitHub(GitLab)上でレビューするフローを採用しています。なるべくテキストベースで設計開発フローを統一するため、私の所属するチームでは以下のようなツールを採用しています。 シーケンス図、業務フロー図Markdown中にPlantUMLで記載 参照はGitHub上からも見れるように、pegmatite を利用 システム構成図など画像系 Diagrams.net(draw.io)で作成し、.drawio.png の拡張子でMarkdownから参照 これだけは目視で差分チェックとなる WebAPI定義OpenAPI SpecのYAMLファイル 参照はGitHub上からも見れるように、swagger-viewer を利用 ER
IntroductionSilverBullet is a tool to develop, organize, and structure your personal knowledge and to makeit universally accessible across all your devices. In SilverBullet you keep your content as a collection ofMarkdown Pages (called a Space). You navigate your space using the Page Picker like a traditionalnotes app, or through Links like a wiki (except they are bi-directional). If you are th
こんにちは、製造業でソフト開発エンジニアをやっているとみー(@tommyecguitar)です。 会社で納品物の説明ドキュメントを作ることがあり、その時にMarkdownでの組版をやってみたので、どう運用したか、困ったところ、いい点、悪い点をまとめてみようと思います。 Vivliostyleで組版したブログはたくさんあるので、見た目がどんな感じにできるかなどはそちらを見ていただくか、Vivliostyleのサイトをご覧ください。 Wordじゃだめなのか。 製造業で何かしら長大なドキュメントを作るとなったら、大抵はWordを複数人数で編集するという運用をしているところが多いと思います。 しかし、Wordにはいろいろと悪いところがあります。 チーム内で共同編集すると、編集したところが消えたり、フォントやデザインがなぜか統一されなかったりする。 セクションごとに担当を分けても、マージが手作業にな

本稿では、gihyo.jp編集部で利用しているMarkdownファイルの記述方法を主に解説します。 注意:gihyo.jp編集部内でのみ採用しているMarkdownの書き方をまとめた文書を、記事の体裁を取って公開したものです。なお、記事公開後に記述方法を追加・変更する可能性もあります。Markdownとは? はじめに、筆者の把握している範囲でMarkdownについて概説しておきます。 近年は一般向けのウェブサービスやテキストエディタでも利用されてきているMarkdown。端的に言えば、テキストファイル上で文書を書くための構文です。文書の読みやすさに焦点を当てており、Markdown形式のテキストファイル(=Markdownファイル)をそのまま見れば文書とその構造が理解できるように、Markdown特有の編集記号や字下げを用いて表現します。また、MarkdownファイルをHTMLファイルに
データアナリティクス事業本部 サービスソリューション部 サービス開発チームのしんやです。Notionの直近リリースノートに「Mermaidっていうマークダウン構文がNotionで使えるようになったよ!」という情報が載っていたので、試してみた内容を軽くではありますが紹介したいと思います。 目次Mermaidとは 実践 #1. フローチャート #2. シーケンス図 #3. クラス図 #4. 状態遷移図 #5. ER図 #6. ジャーニーマップ #7.ガントチャート #8. パイチャート #9. 要件図 まとめMermaidとはMermaidとは、フローチャート、シーケンス図、クラス図、ガントチャート、およびgitグラフを生成するためのマークダウン構文です。 コードから良い感じのグラフを生成できるイメージについては下記動画を参照頂くと良さそうです。 実践 では早速実践してみたいと思いま

はじめにMarkdownって便利ですよね? README.md、PR や Issue の本文やコメント、Qiita やZenn はもちろん、Google Docs や Trello やNotion や JupyterNotebook でも使えるみたいです。もっといろいろな文書をMarkdown で書ければいいのになあ、あらゆる文書のソースコードをMarkdown にできればいいのになあ。 さあ、Markdown の可能性を広げましょう!本記事では「スライド」と「(電子)書籍」をMarkdownで書く方法をご紹介したいと思います。もちろん、VSCodeでMarkdownを効率よく便利に書いていくためのチップスもご紹介していきますよ。 ご参考スライド VS Code Conference Japan 2021 で発表した際の以下スライドもご参照ください。 もちろんこのスライドもV

最初に見つけたのがこのユーザー会さんのページです。こちらにマークダウンとは「文章の書き方」とあります。なるほど簡単。軽量マークアップ言語よりは、かなり柔らかくなりました。ただ、むしろ簡単になりすぎて今度は具体的なイメージが沸かないか? 次に見つけたのは、こちらのブログです。 ここでは、「手軽にドキュメントを装飾できるフォーマット」とあります。うんうん、なんとなくイメージしている説明に近づいてきました。 そして最後に見つけたのが https://wa3.i-3-i.info/word16753.html 単なる「ファイルの書き方ルールの1つ」ですよと。これですかね。 人間社会に「日本語」「英語」「ドイツ語」などの様々な言語があるように、デジタル世界でも、HTMLとかXMLとかPDFとか、いろいろな言語(ファイルの書き方ルール)がある、そのうちの1つがマークダウンという言語。それ以上でも以下で

基本無料のMarkdownエディタ「Obsidian」では、Markdown形式で見やすいノートを記述し、ノート同士にリンクを張ることで自分専用のWikiを構築することができます。そんなObsidianのモバイル版が2021年7月12日に登場したので、実際に使って機能を確かめてみました。 Mobile apps -Obsidian https://obsidian.md/mobileObsidian - ConnectedNotes on the App Store https://apps.apple.com/us/app/obsidian-connected-notes/id1557175442Obsidian -Google Play のアプリ https://play.google.com/store/apps/details?id=md.obsidianObsidia

リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く