Markdown Viewer & Editor — サポート

最終更新日 / Last updated: 2026-09-23

はじめに知っておいていただきたいこと

動作環境

よくある質問

ファイルを開く

起動すると、空の画面しか出ません

最初に出るのは iOS 標準のドキュメントブラウザです。このアプリはファイルを取り込まないので、アプリの中に独自の一覧を持っていません。ここから開きたいファイルを選びます。

• 見本を開く — iCloud にサインインしている端末では、初回起動時に iCloud Drive の「Markdown Viewer」フォルダへ見本の書類（はじめに.md）が 1 つ置かれます。表示されるまで少し時間がかかることがあります
• 新しく書く — 「書類を作成」を押すと、空の書類ができます。右上の鉛筆のボタンから書き始められます
• 手元のファイルを開く — ドキュメントブラウザの「ブラウズ」から、iCloud Drive やこの iPhone 内、ほかのファイル提供元をたどって選びます

ファイル App でタップすると、記号が混じったテキストのまま表示されます

ファイル App のタップで開くのは Quick Look というプレビューで、Markdown はテキストのまま表示されます。この画面はシステムが用意しているもので、アプリ側から見た目を差し替えることはできません。

Markdown Viewer & Editor で読むには、アプリを起動してドキュメントブラウザから開くか、ファイル App でそのファイルを長押しして「共有」から「Markdown Viewer」を選んでください。

.txt のファイルが開けません

意図して対応していません。.txt を開けるようにするには「テキストファイル全般を扱うアプリ」として登録することになり、そうすると .swift や .json、.csv といったあらゆるテキストファイルまで Markdown Viewer で開ける状態になってしまいます。それらを Markdown として描くと、段落に潰れてかえって読みにくくなります。

Markdown で書いたメモを .txt で持っている場合は、拡張子を .md に変えてください。開けるのは .md、.markdown、.mdown、.mkd、.mdtext です。

「このファイルは UTF-8 として読み取れませんでした。」と出ます

文字コードは UTF-8 にだけ対応しています。Shift_JIS などで保存された古いファイルは、文字化けした状態で表示するのではなく、このメッセージを出して止まります。

パソコンのテキストエディタなどで UTF-8 に変換して保存し直すと開けます。BOM の付いた UTF-8 も開けます（BOM はそのまま保ちます）。

表示

書類と同じフォルダに置いた画像が表示されません

iOS は、アプリが利用者の開いていないファイルに触れないよう、開いた書類 1 つぶんの権限をアプリに渡します。プライバシーを守るための仕組みで、そのままでは同じフォルダの画像も読み取れません。画像の代わりに「このフォルダの読み取りが、まだ許可されていません。」と表示されます。

表示するには、次のどれかの方法があります。

• アプリのフォルダに置く — iCloud Drive または「この iPhone 内」の「Markdown Viewer」フォルダにある書類は、そのまま同じフォルダの画像を表示できます
• フォルダを許可する — 画像の下に出る「このフォルダを許可」を押し、その書類が入っているフォルダ（またはその親）を選びます。書類が入っていないフォルダでは有効になりません
• URL で指す — ![](https://…) の形で書かれた画像は、どこにある書類からでも表示できます（通信が必要です）

同じフォルダのほかの .md へのリンク（相対リンク）も、同じ仕組みによるものです。

「まだこの端末に読み込まれていません」と出ます

書類が参照している画像などが iCloud Drive にあり、まだこの端末にダウンロードされていない状態です。ファイル App でそのファイルをタップするとダウンロードが始まります。済んでから書類を開き直してください。

**強調。**続き が太字になりません

Markdown の標準仕様（CommonMark）の規則によるもので、GitHub でも同じ表示になります。閉じる ** が句読点（「。」「、」など）の直後にあり、さらにその直後に文字が続くと、強調の終わりとして扱われません。日本語で自然に書くと踏みやすい規則です。

**強調**。続き のように句読点を ** の外に出すと、太字になります。同じファイルが GitHub と違って見えることのないよう、規則はそのままにしています。

数式（LaTeX）や Mermaid の図は表示できますか

対応していません。記法は GitHub Flavored Markdown の標準の範囲（表・タスクリスト・打ち消し線・自動リンク）です。数式や Mermaid は、書いてあるとおりの文字やコードブロックとして表示されます。将来の候補としては考えていますが、時期はお約束できません。

HTML のタグが、そのまま文字で表示されます

意図した動作です。Markdown の中に書かれた HTML は実行せず、書いてあるとおりの文字として表示します。見知らぬファイルを開いたときに、中のスクリプトなどが動かないようにするためです。

コードの色付けに対応している言語は

コードブロックの言語名（```swift など）を見て、次の言語に色を付けます。

Swift、Objective-C、C、C++、C#、Java、Kotlin、Go、Rust、JavaScript、TypeScript、Python、Ruby、PHP、シェル、SQL、JSON、YAML、TOML、CSS、diff

js、ts、py、rb、sh、bash、yml といった略称も通ります。ほかの言語は、色を付けずに等幅で表示します。言語に関わらず、コードブロックの右上のボタンで中身を丸ごとコピーできます。

リンクをタップするとどうなりますか

https:// のリンクは、アプリの中に開く Safari の画面で表示します。閉じると元の文書に戻ります。

同じフォルダのほかの .md へのリンク（相対リンク）は、読むための画面で開きます。そこでは編集できないので、直したいときはドキュメントブラウザから開き直してください。

編集と保存

編集モードに入るには / プレビューに戻るには

右上の鉛筆のボタンを押すか、本文を長押しします。長押しなら、押した段落の頭にカーソルが立ちます。

編集中は、鉛筆のボタンが青い「完了」に変わります。押すとプレビューに戻ります。外付けキーボードでは ⌘⇧P でも切り替えられます。どちらへ切り替えても、見ていた場所はそのままです。

プレビューで文字を選択してコピーできません

プレビューでの長押しは「そこから編集する」操作に割り当てているため、文字の選択には使えません。文字を選んでコピーしたいときは、編集モードに入ってください。素の Markdown をそのまま選べます。

コードブロックだけはプレビューのままでも選択でき、右上のボタンで丸ごとコピーもできます。

保存ボタンがありません

保存は自動です。保存の操作はありません。プレビューに戻ったときや、アプリを離れるときにも、元のファイルへ確実に書き込みます。

保存すると、改行コードや空白が変わってしまいませんか

変わりません。触っていない行は、バイト単位でそのまま保存します。改行コードの変換、行末の空白の除去、リスト記号の統一、引用符やハイフンの自動変換は、いずれも行いません。

チェックボックスをタップしたときも、書き換わるのは [ ] と [x] の 1 文字だけです。Git で管理しているファイルでも、差分が汚れません。

画像を入れるには

編集モードで、キーボードの上のバーにある画像のボタンを押し、写真を選びます。写真は書類と同じフォルダに画像ファイルとして保存され、本文には ![](image-20260923-094100.jpg) のような行が入ります。

• 書類のあるフォルダに書き込めるときは、そのまま入ります。書き込めないときは、書類が入っているフォルダを選ぶよう求められます
• 読み取り専用のフォルダなど、そもそも書き込めない場所には入れられません
• JPEG・PNG・GIF・WebP はそのままの形式で保存し、HEIC は JPEG に変換して保存します（ほかのアプリでも開けるようにするためです）
• 写真を選ぶ画面は iOS 標準のものなので、写真ライブラリへのアクセス許可は求めません。アプリに渡るのは、選んだ写真だけです

「変更が競合しています」と出ました

同じファイルが、ほかの端末やほかのアプリでも同時に変更されたときに出ます。それぞれの版について、保存した端末の名前・更新時刻・中身の冒頭が並ぶので、見比べて残す版を選んでください。選ばなかった版は破棄されます。

iCloud Drive とファイルの置き場所

iCloud Drive の「Markdown Viewer」フォルダは何ですか

アプリのために用意された置き場所です。ここに入れたファイルは、同じ Apple アカウントでサインインしているほかの端末からも開けます。この中の書類は、同じフォルダの画像を許可なしで表示できます。

見本の書類（はじめに.md）は、初回起動時にここへ 1 つ置かれます。読み終えたら消して構いません。消しても、起動のたびに作り直されることはありません（別の端末で初めて起動したときなどに、その端末のぶんが置かれることはあります）。

アプリを削除すると、ファイルはどうなりますか

iCloud Drive やほかの場所に置いたファイルは、そのまま残ります。アプリはファイルを取り込んでいないので、置いた場所から消えることはありません。

ただし、「この iPhone 内」（iPad では「この iPad 内」）の「Markdown Viewer」フォルダに置いたファイルは、アプリと一緒に削除されます。残したいファイルは、削除する前にほかの場所へ移してください。表示設定やフォルダの許可も、あわせて削除されます。

そのほか

PDF はどのように書き出されますか

書類を開いて、右上の「…」→「PDF として書き出す」を選びます。書体・文字の大きさ・行間は、表示設定のとおりに反映されます。行の幅は紙の幅に合わせます。

テーマがダークのときは、紙に合わせて明るい配色で書き出します（セピアのときは、紙の色もセピアのままです）。PDF に入るのは書類の隣にある画像で、URL で指定した画像は入りません。

外付けキーボードのショートカットは

⌘⇧P	プレビューと編集の切り替え
⌘F	文書内を検索
⌘⇧T	目次
⌘B	太字（編集中）
⌘I	斜体（編集中）
⌘K	リンク（編集中）

iPad では、ステージマネージャや Split View で複数の書類を並べて開けます。

アプリのバージョンを確認したい

書類を開き、右上の「…」→「表示設定」を開くと、いちばん下に「バージョン 1.0.0 (1)」の形で表示されます。同じ画面から、使用しているオープンソースのライセンスも読めます。

お住まいの国の App Store に見当たりません

ヨーロッパ（EU 加盟国のほか、英国・スイス・ノルウェーなど）と中国本土の App Store では配信していません。

データを削除したい

開発者の手元に、削除すべきデータはありません。アカウントもサーバーもなく、ファイルは利用者の端末と iCloud の中にだけあります。

アプリを端末から削除すると、表示設定とフォルダの許可も消えます。ファイルの扱いは、ひとつ上の項目をご覧ください。

Support (English)

Before anything else

Requirements

Opening files

The app opens to an empty screen

The first screen is the system document browser. The app imports nothing, so it keeps no list of its own — you pick the file to open from here.

• Open the sample — on a device signed in to iCloud, the first launch places a sample document (Getting Started.md) in the “Markdown Viewer” folder in iCloud Drive. It can take a moment to appear
• Start something new — tap “Create Document” for an empty document, then the pencil button at the top right to start writing
• Open a file you have — use Browse in the document browser to reach iCloud Drive, On My iPhone, or any other file provider

Tapping a file in the Files app shows it as plain text

Tapping a file in Files opens Quick Look, the system preview, where Markdown is shown as plain text. That preview comes from the system, so how it looks is not something an app can change.

To read the file here, open it from the document browser inside the app, or long-press it in Files and choose Share → Markdown Viewer.

.txt files will not open

That is deliberate. Accepting .txt means registering as an app that handles plain text in general, which would put .swift, .json, .csv and every other text file in reach of this app — and rendering those as Markdown collapses them into paragraphs, which is worse than leaving them alone.

If you keep Markdown notes in .txt files, rename them to .md. The app opens .md, .markdown, .mdown, .mkd, and .mdtext.

“This file couldn't be read as UTF-8.”

UTF-8 is the only encoding supported. A file saved in another encoding is not displayed as garbled text; the app stops and says so instead.

Re-save the file as UTF-8 in a text editor and it will open. UTF-8 with a BOM is fine too, and the BOM is preserved.

Reading

An image sitting next to the document does not show

So that apps cannot reach files you have not opened, iOS hands over permission for that one document and nothing else in the folder. It is there to protect your privacy, and it means an image sitting next to the document cannot be read until you say otherwise. In place of the image you see “The app hasn’t been given access to this folder yet.”

There are three ways to show it:

• Keep the document in the app's own folder — documents in “Markdown Viewer” in iCloud Drive or under On My iPhone show images next to them straight away
• Grant the folder — tap “Allow This Folder” under the image and choose the folder the document lives in, or one of its parents. A folder that does not contain the document will not cover it
• Point at the image by URL — an image written as ![](https://…) shows from any document (this one needs a network connection)

A relative link to another .md in the same folder works the same way.

“Not downloaded to this device yet.”

An image (or another file) the document refers to is in iCloud Drive but has not been downloaded to this device. Tap that file in the Files app to download it, then reopen the document.

Emphasis right before a full stop does not render

This follows the CommonMark rules, and GitHub renders it the same way. A closing ** that sits right after punctuation and right before a letter does not close the emphasis. It is easy to hit when writing Japanese, where a sentence ends inside the emphasis.

Move the punctuation outside the markers and it works. The rule is left as written so that a file does not look different here than it does on GitHub.

Can it show math (LaTeX) or Mermaid diagrams?

No. The supported syntax is standard GitHub Flavored Markdown (tables, task lists, strikethrough, autolinks). Math and Mermaid appear as the text or code block they are written as. Both are on the list of things to consider, with no promised timing.

HTML tags show up as text

That is intended. HTML written inside a Markdown file is shown as text and never executed, so that opening a file from someone else cannot run anything.

Which languages get syntax coloring?

The language written on the code fence (```swift and so on) selects the colors:

Swift, Objective-C, C, C++, C#, Java, Kotlin, Go, Rust, JavaScript, TypeScript, Python, Ruby, PHP, shell, SQL, JSON, YAML, TOML, CSS, and diff.

Short names such as js, ts, py, rb, sh, bash, and yml work too. Any other language is shown monospaced without coloring. Whatever the language, the button at the top right of a code block copies the whole block.

What happens when I tap a link?

An https:// link opens in a Safari view inside the app. Close it and you are back in the document.

A relative link to another .md in the same folder opens in a reading-only view. To edit that file, open it from the document browser instead.

Editing and saving

How do I start editing, and how do I get back?

Tap the pencil button at the top right, or long-press the text. A long press puts the cursor at the start of the paragraph you pressed.

While editing, the pencil becomes a blue Done button; tap it to go back to reading. With a hardware keyboard, ⌘⇧P switches either way. Your place in the document is kept across the switch.

I can't select text while reading

A long press while reading is used to start editing, so it is not available for selecting text. To select and copy, switch to edit mode, where the plain Markdown can be selected as usual.

Code blocks are the exception: they stay selectable while reading, and the button at the top right copies the whole block.

There is no save button

Saving is automatic; there is nothing to press. The file is written back when you return to reading and when you leave the app.

Will saving change my line endings or whitespace?

No. Every line you did not touch is saved byte-for-byte. Line endings are not converted, trailing spaces are not stripped, list markers are not normalized, and smart quotes and dash substitution are off.

Toggling a checkbox rewrites exactly one character, between [ ] and [x]. Files under Git keep clean diffs.

How do I insert an image?

In edit mode, tap the image button in the bar above the keyboard and pick a photo. The photo is saved as a file in the same folder as the document, and a line such as ![](image-20260923-094100.jpg) is inserted.

• If the document's folder can be written to, the image goes straight in. If not, you are asked to choose the folder the document lives in
• Folders that cannot be written to at all, such as read-only ones, will not take an image
• JPEG, PNG, GIF, and WebP are saved as they are; HEIC is converted to JPEG so other apps can open it
• Picking a photo goes through the standard iOS picker, so the app never asks to read your photo library. It receives only the photo you picked

“Conflicting Changes”

The same file was changed somewhere else at the same time — on another device, or in another app. Each version is listed with the device that saved it, when, and how it starts, so you can compare before choosing. The versions you do not keep are discarded.

iCloud Drive and where files live

What is the “Markdown Viewer” folder in iCloud Drive?

It is a place set aside for the app. Files you put there are available on your other devices signed in to the same Apple Account, and documents in it can show images next to them without asking for permission.

The sample document (Getting Started.md) is placed there once, on first launch. Delete it whenever you like; it is not recreated each time the app launches (a device launching the app for the first time places its own copy).

What happens to my files if I delete the app?

Files in iCloud Drive and anywhere else stay exactly where they are. The app never imported them, so nothing disappears from where you put it.

Files in the “Markdown Viewer” folder under On My iPhone (or On My iPad) are deleted with the app. Move anything you want to keep somewhere else first. Your display settings and folder grants are removed as well.

Anything else

How does PDF export work?

Open a document, tap More (…) at the top right, then Export as PDF. Your typeface, text size, and line spacing carry over, and the measure is set to the width of the page.

A dark theme is printed in light colors to suit paper (sepia keeps its paper color). Images next to the document are included; images written as URLs are not.

Hardware keyboard shortcuts

⌘⇧P	Switch between reading and editing
⌘F	Find in document
⌘⇧T	Contents
⌘B	Bold (while editing)
⌘I	Italic (while editing)
⌘K	Link (while editing)

On iPad, several documents can be open side by side in Stage Manager or Split View.

Where do I find the app version?

Open a document, tap More (…) at the top right, then Display. The version is at the bottom, shown as “1.0.0 (1)”. The same screen lists the open source licenses the app uses.

I can't find it on the App Store in my country

The app is not distributed on the App Store in Europe (the EU, and also the UK, Switzerland, Norway and others) or in mainland China.

I want my data deleted

There is nothing held by the developer to delete. There is no account and no server; your files live on your device and in your iCloud.

Deleting the app removes your display settings and folder grants. For what happens to files, see the question above.